Endpoint Specification
POST https://gateway.bunnylynk.com/h/:slug
Any standard HTTP client or third-party webhook producer can dispatch HTTP POST requests to this URL.
Ingestion Flow & Status Codes
| Code | Status | Meaning |
|---|---|---|
200 OK or 202 Accepted | Success | The payload was written to replicated durable storage. Delivery attempts are scheduled. |
400 Bad Request | Client Error | Payload is malformed JSON or exceeds MAX_PAYLOAD_BYTES (10MB). |
401 Unauthorized | Auth Error | Webhook signature verification failed for the configured provider. |
404 Not Found | Not Found | No active Source with the specified :slug exists. |
410 Gone | Disabled | Source exists but has been temporarily disabled by an administrator. |
Headers Passed to Downstream Destinations
When Bunnylynk forwards an event to your destination, it includes:
| Header | Description |
|---|---|
X-Bunnylynk-Event-Id | Unique ID of the event record in Bunnylynk. |
X-Bunnylynk-Attempt | Attempt count (e.g. 1 for initial delivery, 2+ for retries). |
X-Bunnylynk-Source | Source slug that received the event. |
X-Bunnylynk-Delivery-Timestamp | Timestamp when the dispatch attempt was initiated. |
Next: Learn about Migrating from Hookdeck.