Skip to main content
POST
Send Event via Webhook
Sends an event to a workflow via its Event Hub webhook URL.

Usage

Event webhooks allow external services (Telegram, Slack, Stripe, GitHub, etc.) to trigger workflow execution:

Authentication

Webhooks can optionally validate a secret header:
  • No secret: Any request is accepted
  • Secret validation: Requires the correct value in the X-Webhook-Secret header

Payload

Send any JSON payload — it will be stored as an event and routed to subscribed agents. The raw payload becomes the entry node’s output, accessible via variable mappings like {{ start.field_name }}. Payload limit: 10MB

Verification Challenges

The endpoint automatically handles verification challenges from:
  • Slack — responds to url_verification type with the challenge token
  • Facebook/Instagram — responds to hub.mode=subscribe GET requests with hub.challenge

Response

Returns the event ID:

Path Parameters

webhook_id
string<uuid>
required

Event webhook ID (UUID format)

Body

application/json

Any JSON payload from the external service. Stored as-is and routed to subscribed agents.

The body is of type object.

Response

Event received and stored successfully

ok
boolean

Whether the event was stored successfully

event_id
string<uuid>

ID of the stored event