---
title: "Where to post call.started, call.completed, message.received, email.received."
method: POST
path: "/webhook"
---

# Where to post call.started, call.completed, message.received, email.received.

`POST /webhook`

## Request

- Base URL: `https://cosvoice.com/api/v1`
- URL: `https://cosvoice.com/api/v1/webhook`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required: Your HTTPS endpoint.

## Response `200`

Saved.

- object

## Other responses

- `400`: Something in the request is missing or malformed; the message says which field.
- `401`: The key is missing, wrong, or revoked. Ask the owner for a new one; do not retry.
- `404`: No such call, email, or contact on this line.
- `429`: Over 240 requests a minute. Wait a little and try again.

---

[API](https://skmtc.dev/cosvoice/apis/cosvoice-api.md) · [All operations](https://skmtc.dev/cosvoice/apis/cosvoice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cosvoice/apis/cosvoice-api/revisions/4164bbabcd81?raw)