Skip to main content
POST
/
api
/
workflows
/
webhook
Trigger a workflow via webhook
curl --request POST \
  --url https://your-instance.example.com/api/workflows/webhook \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
  "payload": {
    "source": "zillow",
    "lead": {
      "name": "Alex Nguyen",
      "email": "alex.nguyen@example.com",
      "phone": "+14155551234"
    }
  }
}
'
{
  "success": true,
  "message": "Webhook processed successfully"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
webhookId
string
required

Must match a WebhookTrigger.data.webhookId in the caller's org; everything else in the body is forwarded as the trigger payload.

​
payload
object

Arbitrary trigger payload exposed verbatim to the WebhookTrigger node's output and downstream nodes' input.

Response

Webhook processed successfully

Returned by the legacy workflow-webhook ingress family (/api/workflows/webhook, /{applicationId}, /{applicationId}/{status}). For the newer matched-count semantics see /api/webhook/workflow and WorkflowWebhookIngressResponse.

​
success
enum<boolean>
required
Available options:
true
​
message
string