Webhooks

Create a webhook endpoint

Requires the webhooks:write scope.

post/webhook_endpoints

Request

  • Base URL: https://api.meetdarwin.ai/v1
  • URL: https://api.meetdarwin.ai/v1/webhook_endpoints
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry safely: the first response is replayed for 24 hours (not for streamed answers).

Request body

urlstring required
eventsstring[] required
descriptionstring

Example request

{
  "url": "https://example.com/webhooks/darwin"
}

Response

OK

idstring required
object'webhook_endpoint' required
urlstring required
descriptionstring required
eventsstring[] required
status'enabled' | 'disabled' required
disabled_reasonstring nullable required
failing_sincestring date-time nullable required
created_atstring date-time nullable required
updated_atstring date-time nullable required
secretstring

whsec_…, only when the endpoint is created or its secret rotated.

Example response

{
  "id": "we_7h3k9m2p4q8r1s5t"
}

Changes

No recorded changes to this operation across all 1 revision of this API.