Webhooks
Webhooks send real-time notifications to your application whenever something happens in Harmony. Use them to trigger workflows, sync data, or build custom integrations.
How to access webhooks
- Click your workspace name in the top-left corner and select Workspace settings.
- In the settings sidebar under Connections, click Webhooks.
This opens the Webhook Subscriptions page where you can create and manage all your webhooks.
Creating a webhook
To set up a webhook in Harmony, start by going to the Webhook Subscriptions page. Look for the + Create Webhook button in the top-right corner and click it to start the process.
Now, you'll give your webhook a name - choose something that helps you (and your team) quickly recognize what this webhook is for, like "Slack Notifications" or "Data Pipeline Trigger." If you'd like to add a bit more detail, there's also a space for a description. This is a great place to explain the webhook's purpose or what types of events it should handle.
Next, enter your Webhook URL. This is the link (endpoint) where Harmony will send information every time an event you've subscribed to occurs. Make sure your URL uses HTTPS, especially in production, to keep everything secure.
You’ll then see a list called Events to Subscribe To. Here you can pick and choose exactly which events you want Harmony to send to this webhook. Select just the ones you care about, or use the Select All option if you’d like to be notified about everything.
If you want to be sure your chosen endpoint is working, try the handy Test button beside the URL field—Harmony will send a sample request so you can confirm everything is set up correctly.
Once you’re happy with your settings, click Create Webhook. That’s it! Your webhook will start sending you notifications as soon as the relevant events happen in Harmony.
Event categories
Harmony organizes its 59 available webhook events into five categories.
Contact Events (10 events) fire when contacts are created, updated, merged, or deleted. Use these to keep your external systems in sync with your Harmony contact data.
Account Events (7 events) fire when accounts change. These are useful for CRM sync workflows and account-level reporting.
Conversation Events (10 events) fire when meetings are recorded, processed, updated, or deleted. These are the most common events for triggering post-meeting workflows like sending summaries to Slack or syncing transcripts to a data warehouse.
Project Events (6 events) fire when Insight projects are created, updated, or when insight generation completes. Use these to build dashboards or alert systems around your Insight data.
User Events (5 events) fire when users are added, updated, or removed from your workspace.
Managing webhooks
All active webhooks appear on the Webhook Subscriptions page. From here you can edit a webhook's URL or events, temporarily disable it, or delete it entirely.
If a webhook endpoint is unreachable or returns errors, Harmony will retry delivery. Check your endpoint's availability if you notice missing events.
Security
Webhook payloads are sent over HTTPS to protect your data in transit. Validate incoming requests on your server to ensure they are coming from Harmony. Use a unique, hard-to-guess URL path for your webhook endpoint as an additional layer of protection.
Webhook data follows your workspace permissions. Only events you have access to in your workspace are included in payloads.