Create a webhook

post

Create a new webhook.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Body

application/json

descriptionstringOptional

endpointstringRequired

secretstringRequired

Responses

200

Successful Response

application/json

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post

/v1/agents/{agentId}/webhooks

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/webhooks HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "description": "text",
  "endpoint": "text",
  "events": [
    "call.processed"
  ],
  "filters": [
    [
      {
        "a": "text",
        "o": "exist",
        "b": "text"
      }
    ]
  ],
  "secret": "text"
}

{
  "id": "text",
  "agentId": "text",
  "description": "text",
  "events": [
    "call.processed"
  ],
  "endpoint": "text",
  "status": "enabled",
  "createdAt": "2025-12-09T23:06:37.314Z",
  "updatedAt": "2025-12-09T23:06:37.314Z"
}