DAdaily
webhooks

/webhooks

Changed on

Create a webhook

post/webhooks

Request

  • Base URL
    https://api.daily.co/v1
  • Auth
    HTTP bearer

Request body

urlstring

The webhook server endpoint that was provided.

basicAuthstring

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

retryType'circuit-breaker' | 'exponential'

The retry configuration for this webhook endpoint to use. The default is circuit-breaker.

eventTypesstring[]

The set of event types this webhook is subscribed to. Deliveries can be duplicated, and in rare cases a duplicate participant.joined or participant.left delivery carries a different id than the original. Deduplicate those two events on the event type plus the payload's session_id rather than on id. See the webhooks overview for details.

hmacstring

A secret that can be used to verify the signature of the webhook. If not provided, an hmac will be provisioned for you and returned.

Response

200

uuidstring

The unique identifier for this webhook.

urlstring required

The webhook server endpoint that was provided.

hmacstring

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

basicAuthstring

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

retryType'circuit-breaker' | 'exponential'

The retry configuration for this webhook endpoint to use. The default is circuit-breaker.

eventTypesstring[]

The set of event types this webhook is subscribed to. Deliveries can be duplicated, and in rare cases a duplicate participant.joined or participant.left delivery carries a different id than the original. Deduplicate those two events on the event type plus the payload's session_id rather than on id. See the webhooks overview for details.

statestring

The current state of the webhook. "FAILED" | "ACTIVE"

failedCountnumber

The number of consecutive failures this webhook has made.

lastMomentPushedstring

The ISO 8601 time of the last moment an event was pushed to the webhook server.

domainIdstring

The domain ID this webhook is associated with.

createdAtstring

The ISO 8601 time of when this webhook was created.

updatedAtstring

The ISO 8601 time of when this webhook was last updated.

Changes

  • c484c8ebdcfbRevision changes
    • warning

      added the new streaming.warning enum value to the / response property for the response status

    • info

      added the new streaming.warning enum value to the request property /