API referenceWebhook endpoints
Webhook endpoints
Register, manage, and test webhook delivery URLs.
Endpoints are URLs Dolores POSTs events to. Each endpoint has a unique signing secret used to verify the Dolores-Signature header on every delivery — see Verifying signatures.
POST /v1/webhook_endpoints— Create a webhook endpointGET /v1/webhook_endpoints— List webhook endpointsGET /v1/webhook_endpoints/{id}— Retrieve a webhook endpointPATCH /v1/webhook_endpoints/{id}— Update a webhook endpointDELETE /v1/webhook_endpoints/{id}— Delete a webhook endpointPOST /v1/webhook_endpoints/{id}/rotate_secret— Rotate the signing secretPOST /v1/webhook_endpoints/{id}/test— Send a test event
Replay a delivery
Drops a fresh delivery row into the queue for this (event, endpoint) pair. The worker picks it up within a second.
Create a webhook endpoint
Registers a new endpoint. The response includes the signing secret in the `secret` field **once** — save it to your environment, since Dolores stores only an encrypted form.