trigger_event
Fire an event by event type to fan it out to all subscribed endpoints. Returns one delivery ID per subscriber, or an empty array if no subscribers.
Instructions
Fire an event by event type — the backend fans it out to every endpoint subscribed to that type. Returns one delivery id per subscriber (empty if no subscribers). Use send_to_endpoint when you want to target one specific endpoint instead. Example: "fire an order.created event with order_id=ord_123" → event_type="order.created", payload={"order_id": "ord_123"}. An empty delivery_ids array means no endpoint subscribes to that event type — inspect subscriptions with list_endpoints if the user expected a non-empty result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_type | Yes | the event type to fan out (e.g. order.created) | |
| payload | Yes | the event body as a JSON object — passed verbatim to every subscribed endpoint |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_type_id | Yes | echoes the event type that was triggered | |
| delivery_ids | Yes | one delivery id per subscribed endpoint. Empty means the event has no subscribers. | |
| status | Yes | backend acceptance status (typically 'accepted') |