Overview
Listen for events occurring in your workspace in real-time.
How They Work
Webhooks allow you to build or set up integrations that subscribe to certain events in Relay. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL.
Payload Structure
Every webhook delivery includes a standard envelope. The event field indicates what happened, and the payload contains the specifics of the resource that was affected.
Example webhook payload
Copy{
"event": "API_CREATED",
"payload": {
"actorId": 1,
"resourceType": "api",
"resourceId": 123,
"metadata": {
"name": "Production API"
}
},
"timestamp": "2026-09-11T12:00:00.000Z"
}
Retry Logic
If your server returns a non-200 HTTP status code, Relay will automatically retry the delivery up to 5 times. We use an exponential backoff strategy starting at a 2000ms delay.