List endpoints
Create an endpoint
events subscribes to all events.
Retrieve an endpoint
Update an endpoint
Delete an endpoint
Verify incoming signatures
Every webhook request includesX-Webhook-Signature and X-Webhook-Event headers. Verify the signature before processing.
Quick method (Rack/Rails)
Manual method
Full Rails example
sha256=<HMAC-SHA256(secret, raw_body)>.
For routing events to handlers, see Registries.
Webhook attributes
| Attribute | Type | Description |
|---|---|---|
id | Integer | Endpoint ID |
url | String | Your HTTPS endpoint URL |
events | Array | Subscribed event types |
active? | Boolean | Whether endpoint is active |
secret | String | Signing secret (only on create) |
Supported events
| Event | When |
|---|---|
message.received | Inbound message received |
message.status | Message status updated |
message.failed | Message failed to send |
session.connected | Session connected |
session.disconnected | Session disconnected |
session.failed | Session connection failed |
quota.warning | Approaching daily quota |
quota.exceeded | Daily quota exceeded |
agent_run.completed | Agent run finished successfully |
agent_run.failed | Agent run failed |

