Skip to main content
POST
/
events
/
{webhook_id}
Send Event via Webhook
curl --request POST \
  --url https://app.splox.io/api/v1/events/{webhook_id} \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "ok": true,
  "event_id": "0199f456-a12b-3c4d-5e6f-789012abcdef"
}
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: 
curl -X POST https://app.splox.io/api/v1/events/{webhook_id} \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: your-secret" \
  -d '{"key": "value"}'

​
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: 
{
  "ok": true,
  "event_id": "uuid-of-the-stored-event"
}

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