POST /webhooks/endpoints
Subscribe to events by creating a webhook endpoint. Sendi will POST to your URL whenever subscribed events occur.
Authentication
JWT (Dashboard)
Request Body
| Field | Type | Required | Description |
|---|
url | string | Yes | HTTPS URL to receive webhook events |
events | string[] | Yes | Event types to subscribe to |
email.queued, email.sent, email.delivered, email.delivery_delayed, email.bounced, email.rejected, email.complained, email.failed, email.cancelled, email.opened, email.clicked, domain.created, domain.verified, domain.deleted
Response
{
"success": true,
"data": {
"endpoint": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://yourapp.com/webhooks",
"events": ["email.delivered", "email.bounced"],
"secret": "whsec_abc123...",
"active": true,
"created_at": "2026-03-07T12:00:00Z"
}
}
}
Save the secret — use it to verify webhook signatures. It’s only returned at creation.
Limits
| Plan | Max Endpoints |
|---|
| Free | 1 |
| Pro | 10 |
