Skip to main content

Receive a webhook

POST /webhooks/:webhookId

The URL external services POST to.

Created for you when you add a webhook trigger to a workflow — copy the URL from the workflow's webhook settings and give it to the sending service. Requests are verified against the webhook's signing secret, so no API key is involved.

Authentication

  • Webhook signature: Verified against the signing secret stored with the webhook. No API key is involved. Format: provider-specific header.

Path parameters

NameTypeRequiredDefaultDescription
webhookIdstringYes-The webhook id, from the workflow's webhook settings.

Example request

curl -X POST \
{{BASE_URL}}/webhooks/WEBHOOK_ID

Responses

200

Accepted.

{
"ok": true
}

401

The signature did not verify.

{
"error": "INVALID_SIGNATURE",
"message": "Webhook processing failed"
}

503

Temporarily unable to verify signatures.