---
title: Set up webhooks for your organization
description: Set up Avoma webhooks to send real-time meeting and scheduler events to your external systems. Learn how to generate signing secrets, create secure webhooks, validate payloads, and manage webhook integrations.
image: https://help.avoma.com/hubfs/Avoma%20-%20Help%20center.webp
---

[Skip to content](https://help.avoma.com/set-up-webhooks#main-content)

English

Show submenu for translations

![Avoma-Logo](https://help.avoma.com/hs-fs/hubfs/Product%20Newsletter%20Asset/Pricing%20email%20groups/Avoma-Logo.png?width=160&height=37&name=Avoma-Logo.png)

- [Blog](https://www.avoma.com/blog)
- Product
  
  Show submenu for Product

    - [AI Meeting Assistant](https://www.avoma.com/ai-meeting-assistant)
    - [Scheduler and Lead Router](https://www.avoma.com/scheduler-lead-router)
    - [Conversation Intelligence](https://www.avoma.com/conversation-intelligence)
    - [Revenue Intelligence](https://www.avoma.com/revenue-intelligence)
- [Schedule a Demo](https://www.avoma.com/demo)

Open main navigation

Close main navigation

- [Blog](https://www.avoma.com/blog)
- Product
  
  Show submenu for Product

    - [AI Meeting Assistant](https://www.avoma.com/ai-meeting-assistant)
    - [Scheduler and Lead Router](https://www.avoma.com/scheduler-lead-router)
    - [Conversation Intelligence](https://www.avoma.com/conversation-intelligence)
    - [Revenue Intelligence](https://www.avoma.com/revenue-intelligence)
- [Schedule a Demo](https://www.avoma.com/demo)
- English
  
  Show submenu for translations
- [Home](https://www.avoma.com/)

[Home](https://www.avoma.com/)

 How can we help you today?

- There are no suggestions because the search field is empty.

1. [Avoma Help Center | Documentation, Guides & Support](https://help.avoma.com/?hsLang=en)
2. [Avoma Configuration (Admins)](https://help.avoma.com/avoma-configuration-admins?hsLang=en)

# Set up webhooks for your organization

## Connect external systems to receive real-time events from Avoma. Settings → Organization → Developer

Webhooks let you automate workflows by sending real-time notifications to external systems whenever specific events happen in Avoma, such as when meeting notes are ready or when a meeting is scheduled through your scheduler.

This guide shows how to set up your signing secret, create webhooks, and manage them going forward.

| **Before you begin** - You must have Admin privileges in Avoma. - Your organization must be on an Organization or Enterprise plan. Webhooks are not available on the Startup plan. - You need an external endpoint (your server’s URL) that can receive and process webhook events. |
| --- |

### Key sections

- [Set up signing secrets](https://help.avoma.com/set-up-webhooks#signing-secrets)
- [Create your first webhook](https://help.avoma.com/set-up-webhooks#create-webhook)
- [Manage webhooks](https://help.avoma.com/set-up-webhooks#manage-webhooks)

### Set up signing secrets

A signing secret is a secure key that Avoma uses to sign webhook payloads. Your server can verify this signature to confirm that webhook events truly came from Avoma and haven’t been tampered with.

### How It Works: The HMAC-SHA256 Signature

Here's the step-by-step process:

#### On Avoma's side (when sending a webhook):

1. Avoma takes the **raw webhook payload** (the JSON data about the event)
2. Avoma uses your signing secret + a special algorithm called **HMAC-SHA256** to create a unique fingerprint of that data
3. This fingerprint is placed in a header called **X-Avoma-Signature** and sent along with the webhook
4. Your server receives both the payload AND this signature header

#### On your server's side (when receiving a webhook):

1. You receive the webhook payload and the X-Avoma-Signature header
2. You take the **same signing secret** and the **same payload** and run it through the **same HMAC-SHA256 algorithm**
3. Your server generates its own signature fingerprint
4. You **compare** your generated signature with the one Avoma sent in the header
5. **If they match** → The webhook is authentic and untouched ✅
6. **If they don't match** → Either the data was tampered with, or it's a fake webhook ❌

### How to generate a signing secret

**1.** Go to Settings → Organization → Developer.

**2.** Click the Webhooks tab.

| **![Settings → Organization → Developer page with the Webhooks tab highlighted](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-18-6759-AM.png?width=670&height=381&name=undefined-May-18-2026-08-44-18-6759-AM.png)** *Settings → Organization → Developer page with the Webhooks tab highlighted* |
| --- |

**3.** In the “Webhook Signing Secret” section, click Generate.

| ![Webhook Signing Secret section with the Generate button visible and the info icon](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-16-4131-AM.png?width=670&height=381&name=undefined-May-18-2026-08-44-16-4131-AM.png) *Webhook Signing Secret section with the Generate button visible and the info icon* |
| --- |

**4.** A confirmation dialog appears. Click **Generate** again to confirm.

| **![Avoma webhook generation: Confirmation dialog with the warning text and Generate button](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-19-1927-AM.png?width=670&height=381&name=undefined-May-18-2026-08-44-19-1927-AM.png)** *Confirmation dialog with the warning text and 'Generate' button* |
| --- |

**5.** Your new secret is displayed and masked with dots. Click the eye icon to reveal it, or click Copy to copy it to your clipboard.

| **![Avoma Signing secret displayed with masked dots, showing the eye icon and Copy button](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-17-4590-AM.png?width=670&height=383&name=undefined-May-18-2026-08-44-17-4590-AM.png)** *Signing secret displayed with masked dots, showing the eye icon and Copy button* |
| --- |

**6.** Share this secret with your development team or paste it into your webhook processing code. Treat it like a password—never share it publicly.

**Tips**

- Keep your signing secret safe. If you believe it’s been compromised, regenerate it immediately and update your server.
- Use the signing secret to validate webhook events. Your server should compute an HMAC-SHA256 signature of the incoming payload and verify it matches the X-Avoma-Signature header.

### Create your first webhook

Webhooks connect Avoma events to your external systems. You define which event triggers the webhook and where to send the data.

#### Add a webhook

**1:** Go to Settings → Organization → Developer and click the Webhooks tab.

**2:** Click Add webhook.

| **![Avoma Webhooks tab showing the empty state or existing webhooks list with the Add webhook button](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-14-8518-AM.png?width=670&height=382&name=undefined-May-18-2026-08-44-14-8518-AM.png)** *Webhooks tab showing the empty state or existing webhooks list with the Add webhook button* |
| --- |

**3.** In the Name field, enter a descriptive name for this webhook—for example, “Sales meetings AI Notes Sync” or “Sales calls booked via scheduler”

**4.** In the Trigger event dropdown, select the event that should activate this webhook. Common options include:

- **AI notes ready** — fires when Avoma generates meeting notes
- **Meeting booked via scheduler** — fires when a meeting is scheduled through Avoma Scheduler
- **Meeting canceled via scheduler** — fires when a scheduled meeting is canceled
- **Meeting rescheduled via scheduler** — fires when a scheduled meeting’s date or time changes

**5.** Below the trigger event, you’ll see a sample payload. This shows what data your server will receive. Review it to understand the event structure.

| **![Avoma Webhook creation dialog ](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-18-1232-AM.png?width=670&height=381&name=undefined-May-18-2026-08-44-18-1232-AM.png)** *Webhook creation dialog showing the Name field, Trigger event dropdown with an option selected, and sample payload preview below with Copy button* |
| --- |

**6.** In the Target URL field, enter your server’s endpoint—the URL where Avoma will send webhook events. Only HTTPS is supported as of now due to security reasons.

**7.** In the Webhook trigger scope section, choose who can trigger this webhook:

- **All members** — Selected trigger event from any organization member will trigger this webhook (default)
- **Only members in specific teams** — Only events from users in selected teams will trigger this webhook

| **![Avoma webhook creation dialouge](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-15-3946-AM.png?width=670&height=381&name=undefined-May-18-2026-08-44-15-3946-AM.png)** *Webhook creation dialog showing the Target URL input field and Webhook trigger scope section with All members and specific teams radio button options* |
| --- |

**8.** (Optional) Click Show Advanced Options to add custom headers. Use this if your server needs custom headers for authentication or routing with each webhook request.

**9.** Review all your settings and click Add webhook.

| **![Avoma webhook advanced options](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-14-2836-AM.png?width=670&height=382&name=undefined-May-18-2026-08-44-14-2836-AM.png)** *Webhook creation dialog with Advanced Options section expanded, showing custom header input fields for Header Name and Header Value with Delete button* |
| --- |

 

**NOTE:**  Avoma will not send webhook events if your target URL returns an error or doesn’t respond within a reasonable time. Test your endpoint before deploying.

**Tips**

- Choose a descriptive webhook name that identifies its purpose and destination. This makes it easier to manage as you add more webhooks.
- If you only need to monitor meetings from specific teams, use the scope selector to limit unnecessary requests.
- Start with a single webhook to test the integration. Once it’s working, add more as needed.

### Manage webhooks

Once webhooks are set up, you can edit, test, or delete them anytime.

#### Edit a webhook

**1.** Go to Settings → Organization → Developer and click the Webhooks tab.

**2.** Find the webhook in the list and click the pencil icon.

| **![Avoma Webhooks list showing multiple webhooks with the pencil icon in the Actions column](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-19-8800-AM.png?width=670&height=382&name=undefined-May-18-2026-08-44-19-8800-AM.png)** *Webhooks list showing multiple webhooks with the pencil icon in the Actions column* |
| --- |

**3.** Update any field: name, trigger event, target URL, scope, or headers.

**4.** Click Save and apply. Your webhook is now using the updated settings.

| **![Avoma Webhook edit dialog showing updated fields with the Save and apply button](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-15-8824-AM.png?width=670&height=382&name=undefined-May-18-2026-08-44-15-8824-AM.png)** *Webhook edit dialog showing updated fields with the Save and apply button* |
| --- |

**NOTE:**  Editing a webhook does not affect other webhooks. Changes take effect immediately.

#### Delete a webhook

**1.** Find the webhook in the list and click the trash icon.

| **![Avoma Webhooks list with the trash/delete icon visible in the Actions column](https://help.avoma.com/hs-fs/hubfs/undefined-May-18-2026-08-44-16-9198-AM.png?width=670&height=382&name=undefined-May-18-2026-08-44-16-9198-AM.png)** *Webhooks list with the trash/delete icon visible in the Actions column* |
| --- |

**2.** A confirmation dialog shows the webhook name, target URL, and trigger event. Review to confirm this is the right webhook.

**3.** Click **Delete**. The webhook is permanently removed and will no longer send events.

| ![delete webhook dialouge](https://help.avoma.com/hs-fs/hubfs/delete%20webhook%20dialouge.png?width=670&height=383&name=delete%20webhook%20dialouge.png)*Delete confirmation dialog showing the webhook name, target URL, trigger event, and Delete button with warning text* |
| --- |

**Important:**  Deleting a webhook is permanent. Any external systems depending on it will stop receiving events. Be sure to have a replacement webhook ready or notify your team of the change.

 

### **Common questions**

**What happens if my server doesn’t respond to a webhook?**

Avoma will retry the webhook request a limited number of times. If your server is down or slow, events may not be delivered. Check your server logs and endpoint availability.

**Can I send webhooks for only certain teams?**

Yes. When creating or editing a webhook, use the Webhook trigger scope section to select specific teams. The webhook will only fire for events from members in those teams.

**How do I know if a webhook was triggered?**

Check your server logs. Avoma sends HTTP POST requests to your target URL. If the webhook fires but your server doesn’t process it, you’ll see the request in your logs but no downstream action will occur. Also check that your Target URL is correct and your endpoint is responding with a success status code.

**Can I add custom headers to secure my webhooks?**

Yes. Click Show Advanced Options when creating or editing a webhook. Add headers like Authorization with a Bearer token or a custom API key. Your server can check these headers to validate that the request came from Avoma.

**What’s the difference between the signing secret and custom headers?**

**Signing secret** — Avoma signs the entire request body using your secret. Your server cryptographically verifies the signature to confirm the payload is authentic and unmodified. **Custom headers** — These are additional headers (like an API token) you add to each webhook request for your server to validate. Use these for simple authentication or routing. For maximum security, use both.

**How many webhooks can I create?**

The maximum number of webhooks per event type depends on your plan. Check your plan details in Avoma or contact our support team for more details.

**Can I test a webhook before deploying?**

Yes. Use a free online webhook testing tool to create a temporary endpoint, add a webhook pointing to it, trigger an event in Avoma, and see the payload in the service’s dashboard. This confirms the structure and content before integrating with your real system.

**Related articles**

- [How to create and manage your Avoma API keys](https://help.avoma.com/api-integration-for-avoma?hsLang=en)
- [Avoma API documentation](https://dev.avoma.com/)

- [Avoma Configuration (Admins)](https://help.avoma.com/avoma-configuration-admins?hsLang=en#main-content)

    - [Authentication](https://help.avoma.com/avoma-configuration-admins?hsLang=en#authentication)
    - [User and access management](https://help.avoma.com/avoma-configuration-admins?hsLang=en#user-and-access-management)
    - [Recording, privacy, compliance](https://help.avoma.com/avoma-configuration-admins?hsLang=en#recording-privacy-compliance)
    - [Integrations & tool connections](https://help.avoma.com/avoma-configuration-admins?hsLang=en#integrations-tool-connections)
    - [Billing and license management](https://help.avoma.com/avoma-configuration-admins?hsLang=en#billing-and-license-management)
    - [Meeting Assistant configuration](https://help.avoma.com/avoma-configuration-admins?hsLang=en#meeting-assistant-configuration)
    - [Conversation Intelligence configuration](https://help.avoma.com/avoma-configuration-admins?hsLang=en#conversation-intelligence-configuration)
    - [Revenue Intelligence configuration](https://help.avoma.com/avoma-configuration-admins?hsLang=en#revenue-intelligence-configuration)
    - [Adoption, usage, and ROI](https://help.avoma.com/avoma-configuration-admins?hsLang=en#adoption-usage-and-roi)
    - [Lead routing configuration](https://help.avoma.com/avoma-configuration-admins?hsLang=en#lead-routing-configuration)
- [Avoma Configuration (Members)](https://help.avoma.com/avoma-configuration-members?hsLang=en#main-content)

    - [AI Meeting Assistant](https://help.avoma.com/avoma-configuration-members?hsLang=en#ai-meeting-assistant)
- [Avoma Quick Start](https://help.avoma.com/avoma-quick-start?hsLang=en#main-content)

    - [Getting started videos](https://help.avoma.com/avoma-quick-start?hsLang=en#getting-started-videos)
- [Preparing for a Meeting](https://help.avoma.com/preparing-for-a-meeting?hsLang=en)
- [Avoma Scheduler](https://help.avoma.com/avoma-scheduler?hsLang=en)
- [Using Avoma During a Meeting](https://help.avoma.com/using-avoma-during-a-meeting?hsLang=en)
- [After Meeting Workflows](https://help.avoma.com/after-meeting-workflows?hsLang=en#main-content)

    - [Meeting notes sync to CRM](https://help.avoma.com/after-meeting-workflows?hsLang=en#meeting-notes-sync-to-crm)
- [Conversation Insights](https://help.avoma.com/conversation-insights?hsLang=en)
- [Revenue Intelligence](https://help.avoma.com/revenue-intelligence?hsLang=en#main-content)

    - [CRM Field Mapping and Updates](https://help.avoma.com/revenue-intelligence?hsLang=en#crm-field-mapping-and-updates)
    - [Forecast](https://help.avoma.com/revenue-intelligence?hsLang=en#forecast)
    - [AI Win loss Analysis](https://help.avoma.com/revenue-intelligence?hsLang=en#ai-win-loss-analysis)
- [Integrations](https://help.avoma.com/integrations?hsLang=en#main-content)

    - [CRMs](https://help.avoma.com/integrations?hsLang=en#crms)
    - [Conferencing](https://help.avoma.com/integrations?hsLang=en#conferencing)
    - [Dialer](https://help.avoma.com/integrations?hsLang=en#dialer)
    - [Calendar](https://help.avoma.com/integrations?hsLang=en#calendar)
    - [Collaboration](https://help.avoma.com/integrations?hsLang=en#collaboration)
    - [Zoom](https://help.avoma.com/integrations?hsLang=en#zoom)
- [FAQs](https://help.avoma.com/faqs?hsLang=en)
- [Best Practices](https://help.avoma.com/best-practices?hsLang=en)
- [Quick Hit Feature Videos](https://help.avoma.com/quick-hit-feature-videos?hsLang=en)
- [Pricing Questions](https://help.avoma.com/pricing-questions?hsLang=en#main-content)

    - [Trial](https://help.avoma.com/pricing-questions?hsLang=en#trial)
    - [Add-Ons](https://help.avoma.com/pricing-questions?hsLang=en#add-ons)
    - [Base Subscription Plans](https://help.avoma.com/pricing-questions?hsLang=en#base-subscription-plans)
    - [Security](https://help.avoma.com/pricing-questions?hsLang=en#security)
- [AI Meeting Assistant](https://help.avoma.com/ai-meeting-assistant?hsLang=en)
- [Meeting Collaboration](https://help.avoma.com/meeting-collaboration?hsLang=en)
- [What's New](https://help.avoma.com/whats-new?hsLang=en)
- [Troubleshooting Call Issues](https://help.avoma.com/troubleshooting-call-issues?hsLang=en)
- [Coaching](https://help.avoma.com/coaching?hsLang=en)
- [Avoma extension](https://help.avoma.com/avoma-extension?hsLang=en)

[![Chill listening crop-3](https://help.avoma.com/hs-fs/hubfs/Avoma_Logo_Dark_Large-2.png?width=100&height=24&name=Avoma_Logo_Dark_Large-2.png "Chill listening crop-3")](https://help.avoma.com?hsLang=en)

Avoma Help Center

<https://www.linkedin.com/company/avoma/> [mailto:help@avoma.com](mailto:help@avoma.com)

Copyright © 2025, Avoma, Inc.