/

Sending events

Send an event

One API call fans out to every endpoint that listens for that event type.

3 min read

Send an event to the app it belongs to. Sluice answers as soon as the event is stored, before any delivery happens, so the call is fast even when a customer's server is slow.

curl https://api.sluicehq.dev/v3/apps/cus_1042/events \
  -H "Authorization: Bearer sk_test_4f9a2c7e1b" \
  -H "Content-Type: application/json" \
  -d '{"type": "invoice.paid", "payload": {"invoice": "inv_8841"}}'
curl https://api.sluicehq.dev/v3/apps/cus_1042/events \
  -H "Authorization: Bearer sk_test_4f9a2c7e1b" \
  -H "Content-Type: application/json" \
  -d '{"type": "invoice.paid", "payload": {"invoice": "inv_8841"}}'
curl https://api.sluicehq.dev/v3/apps/cus_1042/events \
  -H "Authorization: Bearer sk_test_4f9a2c7e1b" \
  -H "Content-Type: application/json" \
  -d '{"type": "invoice.paid", "payload": {"invoice": "inv_8841"}}'

What your customer receives

{
  "id": "evt_2Vd9kQ",
  "type": "invoice.paid",
  "created_at": "2026-09-09T14:02:11Z",
  "data": { "invoice": "inv_8841" }
}
{
  "id": "evt_2Vd9kQ",
  "type": "invoice.paid",
  "created_at": "2026-09-09T14:02:11Z",
  "data": { "invoice": "inv_8841" }
}
{
  "id": "evt_2Vd9kQ",
  "type": "invoice.paid",
  "created_at": "2026-09-09T14:02:11Z",
  "data": { "invoice": "inv_8841" }
}

Limits

Limit

Value

Payload size

256 KB

Requests per second

100 per key

Event types per event

1

Sending the same event twice by accident is the most common mistake. Add an idempotency key to every request.

Something missing or wrong on this page? Tell us at support@sluicehq.dev and we will fix it.

Create a free website with Framer, the website builder loved by startups, designers and agencies.