Events

Send an event

POST

/v3/apps/{app}/events

Store an event and deliver it to every endpoint in the app that listens for its type.

Parameters

Name	Type	Description
`type`	string, required	An event type you have defined
`payload`	object, required	Up to 256 KB of JSON
`idempotency_key`	string	Same as the Idempotency-Key header

Request

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

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

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

Response

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

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

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

Retrieve an event