POST
/webhooks

Beta feature

Contact us at help@daily.co to get access.

A POST request to /webhooks creates a new webhook.

Creates a new webhook. Returns an error if the webhook URL provided does not return a 200 status code within a few seconds. Upon creation, new sessions should begin to emit the events specified in the eventTypes field.

Body params

string

The webhook server endpoint that was provided.

string

The basic auth credentials that will be used to POST to the webhook URL.

The set of event types this webhook is subscribed to.

Response Body Parameters

string

The unique identifier for this webhook.

string

The webhook server endpoint that was provided.

string

A secret that can be used to verify the signature of the webhook.

string

The basic auth credentials that will be used to POST to the webhook URL.

The set of event types this webhook is subscribed to.

number

The current state of the webhook. FAILED: 0, ACTIVE: 1, STOPPED: 2.

The number of consecutive failures this webhook has made.

The Unix epoch time in seconds of the last moment an event was pushed to the webhook server.

string

The domain ID this webhook is associated with.

number

The Unix epoch time in seconds of when this webhook was created.

number

The Unix epoch time in seconds of when this webhook was last updated.

Example requests