Email Delivery Status
The email delivery status webhook receives updates from email providers about the delivery status of outgoing ticket notification emails. This lets the platform track whether emails were delivered, bounced, failed, or opened.
Endpoint
Section titled “Endpoint”POST /api/rpc/tickets/email/delivery-status
This is a public endpoint with no authentication. Configure your email provider to send delivery status updates to this URL.
Payload
Section titled “Payload”| Field | Required | Type | Description |
|---|---|---|---|
providerMessageId | Yes | string | The email provider’s message ID |
event | Yes | string | One of: delivered, bounced, failed, opened |
errorCode | No | string | Error code for bounce or failure events |
errorMessage | No | string | Human-readable error description |
timestamp | No | ISO 8601 | When the event occurred (defaults to current time) |
Events
Section titled “Events”| Event | Description |
|---|---|
delivered | The email was successfully delivered to the recipient’s mail server |
bounced | The email bounced (address doesn’t exist, mailbox full, etc.) |
failed | The email failed to send due to a provider error |
opened | The recipient opened the email (if open tracking is enabled) |
Response
Section titled “Response”{ "success": true}The endpoint always returns success: true to prevent email providers from retrying the request unnecessarily.
Related pages
Section titled “Related pages”- Inbound email — receiving customer email replies
- Webhooks overview — how webhooks work