Documentation
Webhooks & DLR
TrustRouter normalizes delivery receipts and inbound messages across all providers into a consistent format.
Webhook types
Delivery receipts (DLR)
Status updates: delivered, failed, pending, read
Inbound messages
Replies and user-initiated messages
Status callbacks
Provider-specific status codes normalized to common format
DLR normalization
Each provider returns delivery data in different formats. TrustRouter normalizes this into a single schema:
- Consistent status codes regardless of provider
- Unified timestamp format (ISO 8601)
- Consistent message identifiers
- Normalized error categories
Best practices
- Use HTTPS endpoints with valid certificates
- Implement idempotent webhook handlers
- Respond with 2xx quickly, process asynchronously
- Set up retry/dead-letter handling for failed deliveries