Skip to main content

Create an incoming webhook (returns secret once)

POST 
/v1/webhooks/incoming

Create an incoming webhook and get back the URL external systems can post to.

slug is required and must be unique and URL-safe, since it forms the address; name, description, expected_schema and is_active are optional. The response contains the id, slug, live url and a secret.

The secret is shown exactly once and cannot be retrieved later — store it now, or rotate it if you lose it. Use the returned id as a webhook trigger node's webhook_id to wire this receiver to a workflow.

Requires the webhooks:write scope.

Request​

Responses​

Successful Response

Last updated on