{
"type": "message.routing",
"route_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T13:15:46.404433272Z",
"data": {
"id": "route-msg-12345",
"from": "customer@gmail.com",
"reply_to": "customer@gmail.com",
"to": "support@yourdomain.com",
"subject": "Help with my account",
"message_id": "<unique-message-id@gmail.com>",
"size": 2048,
"spam_score": 0.1,
"bounce": false,
"cc": "",
"date": "Mon, 06 May 2024 13:15:46 +0000",
"in_reply_to": "",
"references": "",
"auto_submitted": "",
"html_body": "<p>I need help with my account settings.</p>",
"plain_body": "I need help with my account settings.",
"reply_from_plain_body": "I need help with my account settings.",
"attachments": [
{
"filename": "logo.png",
"content_type": "image/png",
"content_id": "logo-123",
"disposition": "inline",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB..."
}
],
"headers": {
"X-Mailer": "Gmail",
"X-Priority": "3"
}
}
}Message Routing
message.routing Inbound Email Webhook Event
Reference for the AhaSend message.routing event: the JSON payload with sender, subject, HTML and text bodies, attachments and headers for inbound email.
WEBHOOK
message.routing
{
"type": "message.routing",
"route_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T13:15:46.404433272Z",
"data": {
"id": "route-msg-12345",
"from": "customer@gmail.com",
"reply_to": "customer@gmail.com",
"to": "support@yourdomain.com",
"subject": "Help with my account",
"message_id": "<unique-message-id@gmail.com>",
"size": 2048,
"spam_score": 0.1,
"bounce": false,
"cc": "",
"date": "Mon, 06 May 2024 13:15:46 +0000",
"in_reply_to": "",
"references": "",
"auto_submitted": "",
"html_body": "<p>I need help with my account settings.</p>",
"plain_body": "I need help with my account settings.",
"reply_from_plain_body": "I need help with my account settings.",
"attachments": [
{
"filename": "logo.png",
"content_type": "image/png",
"content_id": "logo-123",
"disposition": "inline",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB..."
}
],
"headers": {
"X-Mailer": "Gmail",
"X-Priority": "3"
}
}
}AhaSend sends this event when an inbound email is received and processed through a configured route.
Purpose: This webhook delivers complete inbound email data to your application for processing inbound emails (like support tickets, replies, etc.).
Difference from message events:
- Route events: Process inbound emails sent TO your domains
- Message events: Track outbound emails sent FROM your domains
- Configure routes in your AhaSend dashboard
- Choose whether to include attachments and headers
- Set recipient filters and processing options
attachments includes conventional attachments,
inline MIME parts (such as images referenced by cid: URLs in html_body), and
filename-bearing MIME parts that omit the Content-Disposition header.
Use cases:
- Support ticket systems
- Email-to-ticket conversion
- Automated email processing
- Reply handling
Related Guides
- API authentication, Permission scopes, Inbound routing setup.
- Route CLI, Local route testing, Signature verification.
- Retry policy, API errors, API rate limits.
Body
application/json
The event type
Available options:
message.routing When the event occurred (ISO 8601 format)
The route ID (the same ID as returned by the Create Route API)
Show child attributes
Show child attributes
Response
Webhook received successfully