Message Routing

Inbound Message Route Event

Triggered 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

Route configuration:

Configure routes in your AhaSend dashboard
Choose whether to include attachments and headers
Set recipient filters and processing options

Use cases:

Support ticket systems
Email-to-ticket conversion
Automated email processing
Reply handling

When it’s sent: When an inbound email matches a configured route.

POST

message.routing

Body

application/json

type

enum<string>

required

The event type

Available options:

message.routing

timestamp

string<date-time>

required

When the event occurred (ISO 8601 format)

route_id

string<uuid>

required

The route ID (the same ID as returned by the Create Route API)

data

object

required

Show child attributes

data.id

string

required

Unique route message ID

data.from

string<email>

required

Sender email address

data.to

string<email>

required

Recipient email address (your route endpoint)

data.subject

string

required

Email subject line

data.message_id

string

required

Original Message-ID header

data.size

integer

required

Email size in bytes

data.bounce

boolean

required

Whether this is a bounce message

data.html_body

string

required

HTML body content

data.plain_body

string

required

Plain text body content

data.reply_to

string<email>

Reply-to email address

data.spam_score

number<float>

Spam score (0.0 to 10.0)

data.cc

string

CC recipients

data.date

string

Date header from the email

data.in_reply_to

string

In-Reply-To header

data.references

string

References header

data.auto_submitted

string

Auto-Submitted header

data.reply_from_plain_body

string

Extracted reply content from plain body

data.attachments

object[]

Email attachments (if route is configured to include them)

Show child attributes

data.attachments.filename

string

required

Attachment filename

data.attachments.content_type

string

required

MIME content type

data.attachments.data

string

required

Base64-encoded attachment data

data.attachments.content_id

string

Content-ID for inline attachments

data.headers

object

Email headers (if route is configured to include them)

Show child attributes

data.headers.{key}

string

Response

Webhook received successfully

Retry Policy Send Email (Legacy)

⌘I

Overview

API reference

Webhooks

Message Routing

API v1 (legacy)

Inbound Message Route Event

Body

Response