# Avoma Webhooks API

**Canonical:** https://apis.io/apis/avoma/avoma-webhooks-api/  
**Provider:** Avoma — https://apis.io/providers/avoma/  
**Base URL:** https://api.avoma.com  
**Documentation:** https://dev.avoma.com/

Avoma Webhooks API is one of 18 APIs that [Avoma](https://apis.io/providers/avoma/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification.

**Webhooks** Avoma Webhooks notify users about the successful occurrence of events within the Avoma application. Instead of polling or calling APIs to detect events, Avoma sends webhook events as HTTP POST requests, with a JSON payload, to your specified endpoint URL. **Subscribing to Webhooks** To subscribe to webhooks, please reach out to Avoma support and provide a public HTTPS endpoint URL. The URL must be secure (HTTPS). Your endpoint should respond with an HTTP **200** status code to acknowledge receipt of the webhook data. If no response or an error is returned, Avoma will retry the connection up to five times within 24 hours. To avoid retries and errors, always acknowledge the receipt of webhooks by responding with HTTP **200**. If persistent non-success responses are received more than five times in the last 24 hours, Avoma will unsubscribe your webhooks. **Supported event types** | `event_type` | Fires when | |---|---| | `AINOTE` | AI notes are ready for a meeting or call. | | `MEETING_BOOKED_VIA_SCHEDULER` | A meeting is booked via an Avoma scheduling page. | | `MEETING_BOOKED_VIA_SCHEDULER_RESCHEDULED` | A scheduler-booked meeting is rescheduled. | | `MEETING_BOOKED_VIA_SCHEDULER_CANCELED` | A scheduler-booked meeting is canceled. | | `new_conversation` | AI notes ready (Zapier only). | **Retry policy** Failed deliveries (non-2xx or timeout) are retried up to 5 times with increasing delays: 5 min → 30 min → 2 h → 12 h → 24 h. After 5 consecutive failures the subscription is automatically deactivated. **Signature verification** When a signing secret is configured, every delivery includes an `X-Avoma-Signature` header — an HMAC-SHA256 hex digest of the raw request body. To verify the signature: 1. Retrieve the payload from the received webhook event. 2. Obtain your Avoma API secret key (provided when you requested API/Webhooks access). 3. Compute the HMAC using the payload and your secret key, using the SHA256 digest algorithm. 4. Convert the result to a hexadecimal format. 5. Compare the computed value to the value in the `X-Avoma-Signature` header. If they match, the webhook is from Avoma. **Sample Code for Webhook Verification** *Node.js:* ```javascript const crypto = require('crypto'); const message = `${JSON.stringify(request.body)}`; const hashForVerify = crypto.createHmac('sha256', AVOMA_API_KEY).update(message).digest('hex'); const signature = `${hashForVerify}`; if (request.headers['x-avoma-signature'] === signature) { // Webhook request came from Avoma } else { // Webhook request did not come from Avoma } ``` *Python:* ```python import hashlib import hmac import json request = "YOUR WEBHOOK REQUEST" secret_key = "YOUR_SECRET_KEY" body_unicode = request.body.decode("utf-8") h = hmac.new(secret_key.encode('utf-8'), body_unicode.encode('utf-8'), hashlib.sha256) # Compare the computed signature with the signature from the request lowercase_headers = {key.lower(): value for key, value in request.headers.items()} webhook_signature = lowercase_headers.get('x-avoma-signature') if webhook_signature != h.hexdigest(): print("Webhook signature does not match") ``` . Manage your signing secret via `GET/PATCH/DELETE /v1/webhooks/signing-secret/` or rotate it via `POST /v1/webhooks/signing-secret/rotate/`.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/webhooks/` | List Webhook Subscriptions |
| POST | `/v1/webhooks/` | Create Webhook Subscription |
| POST | `/v1/webhooks/ainote/` | Event payload: AINOTE |
| POST | `/v1/webhooks/meeting_booked_via_scheduler/` | Event payload: MEETING_BOOKED_VIA_SCHEDULER |
| POST | `/v1/webhooks/meeting_booked_via_scheduler_canceled/` | Event payload: MEETING_BOOKED_VIA_SCHEDULER_CANCELED |
| POST | `/v1/webhooks/meeting_booked_via_scheduler_rescheduled/` | Event payload: MEETING_BOOKED_VIA_SCHEDULER_RESCHEDULED |
| POST | `/v1/webhooks/new_conversation/` | Event payload: new_conversation (Zapier) |
| DELETE | `/v1/webhooks/signing-secret/` | Clear Webhook Signing Secret |
| GET | `/v1/webhooks/signing-secret/` | Get Webhook Signing Secret |
| PATCH | `/v1/webhooks/signing-secret/` | Set Webhook Signing Secret |
| POST | `/v1/webhooks/signing-secret/rotate/` | Rotate Webhook Signing Secret |
| DELETE | `/v1/webhooks/{uuid}/` | Delete (Deactivate) Webhook Subscription |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/avoma/refs/heads/main/openapi/avoma-webhooks-api-openapi.yml

## Other Avoma APIs (12)

- [Avoma Calls API](https://apis.io/apis/avoma/avoma-calls-api/)
- [Avoma Custom Category API](https://apis.io/apis/avoma/avoma-custom-category-api/)
- [Avoma Engagement Analytics API](https://apis.io/apis/avoma/avoma-engagement-analytics-api/)
- [Avoma Meeting Outcomes API](https://apis.io/apis/avoma/avoma-meeting-outcomes-api/)
- [Avoma Meeting Types API](https://apis.io/apis/avoma/avoma-meeting-types-api/)
- [Avoma Meetings API](https://apis.io/apis/avoma/avoma-meetings-api/)
- [Avoma Meetings Sentiments API](https://apis.io/apis/avoma/avoma-meetings-sentiments-api/)
- [Avoma Notes API](https://apis.io/apis/avoma/avoma-notes-api/)
- [Avoma Recording API](https://apis.io/apis/avoma/avoma-recording-api/)
- [Avoma Revenue Intelligence [Beta] API](https://apis.io/apis/avoma/avoma-revenue-intelligence-beta-api/)
- [Avoma Scorecard Evaluations API](https://apis.io/apis/avoma/avoma-scorecard-evaluations-api/)
- [Avoma Scorecards API](https://apis.io/apis/avoma/avoma-scorecards-api/)

## Tags

Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/avoma/avoma-webhooks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/avoma/.