Subscribe

Subscribe to video_ready and video_error, or replace the URL of an existing subscription. One webhook per workspace: posting again overwrites what was there.

The body is validated strictly — any field other than url, enabled and techEmail is rejected with a 400.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
curl -X POST 'https://apis.elai.io/api/v1/webhook/' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "<url>"
}'
{
  "url": "https://site.com/webhook",
  "enabled": true
}
Body Params
string
required

Where we POST each event. HTTPS only — an http:// URL is rejected. URLs containing localhost or elai.io are rejected as well, so you cannot point a webhook back at us or at your own machine. Maximum 2048 characters.

The schema treats this as optional, but the handler rejects a missing URL, so treat it as required.

string

Address we email when deliveries start failing, and again before the webhook is disabled. Must contain @ or the request is rejected with Email is not valid. Maximum 254 characters. If omitted we email the user who created the video instead.

boolean
Defaults to true

Whether the webhook is active. Defaults to true, so you normally omit it. Sending false subscribes the URL but leaves it switched off — and a secret set while a webhook is switched off is silently discarded (see Set secret token).

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json