Webhooks

Create a webhook

Create a session-event webhook.

MethodPath
POST/v1/webhooks

Save the signing secret returned once in this response. Verify the initial ping, then request activation through Support.

curl -X POST "https://api.ellipsis.dev/v1/webhooks" \
  -H "Authorization: Bearer $ELLIPSIS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/ellipsis",
  "events": [
    "session.create"
  ]
}'

Request

Example request body
{
"url": "https://example.com/ellipsis",
}

Body parameters

descriptionstring
eventsarray<string>required

Explicit event subscriptions. Currently only session.create is supported. Pings are sent independently of subscriptions.

urlstringrequired

The single public HTTPS URL to receive signed POST requests. Changing it requires verification and approval again.

Response

Example response, 201
{
"secret": "string",
}

On this page

No Headings
Schedule a demo