---
title: "Create a call webhook"
method: POST
path: "/v1/calls/webhooks"
tags: ["Call webhooks"]
---

# Create a call webhook

`POST /v1/calls/webhooks`

Registers a callback URL for the `on-call` or `post-call` event. Wavix sends a POST callback to the URL when the event occurs.

## Request body

- CallWebhooksCreateRequest
  - `url` string, uri, required — Webhook URL to send call events to.
  - `event_type` 'post-call' | 'on-call', required — Allowed values: `on-call`, `post-call`. - `on-call`: Sends real-time status updates when a call starts, is answered, and ends. - `post-call`: Sends a callback after the call ends with disposition, duration, and cost.

## Response `201`

Returns the created call webhook.

- CallWebhook — A call webhook response
  - `success` boolean, required — Indicates whether the request was successful.
  - `event_type` 'post-call' | 'on-call', required — Type of call event the webhook subscribes to. One of `post-call` (delivered once after the call ends) or `on-call` (delivered for in-call events while the call is active).
  - `url` string, uri, required — Webhook URL

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)