v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0114775543.6 KB
Webhooks

Create a webhook

Create a new webhook with subscriptions for specific agents and events.

400 is also returned when the endpoint URL is already registered: "A webhook with this URL has already been registered"

post/webhook

Request body

endpointstring required

The webhook endpoint URL

descriptionstring required

The description of the webhook

Example request

{
  "endpoint": "https://example.com/webhook",
  "description": "Webhook for conversation events",
  "events": [
    {
      "agentId": "60d0fe4f5311236168a109ca",
      "eventType": "post-conversation"
    }
  ]
}

Response

Webhook created successfully

statusboolean
datastring

The ID of the created webhook

Example response

{
  "status": true,
  "data": "60d0fe4f5311236168a109ca"
}