> ## Documentation Index
> Fetch the complete documentation index at: https://ahasend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.




## OpenAPI

````yaml /webhooks.yaml webhook message.routing
openapi: 3.1.0
info:
  title: AhaSend Webhooks
  description: >
    AhaSend webhook events documentation. This specification describes all
    webhook events that AhaSend sends to your configured webhook URLs.


    ## Overview


    Webhooks are HTTP callbacks that AhaSend sends to your configured URLs when
    specific events occur. They provide real-time notifications about:


    - **Message Events**: Email delivery status (sent, delivered, bounced,
    opened, etc.)

    - **Suppression Events**: When email addresses are automatically suppressed

    - **Domain Events**: DNS configuration issues

    - **Route Events**: Inbound email processing


    ## Standard Webhooks Compliance


    AhaSend webhooks are fully compatible with the [Standard Webhooks
    specification](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md),
    ensuring consistent and secure webhook delivery.


    ### Security Headers


    All webhooks include these security headers for verification:


    - `webhook-id`: Unique identifier for the webhook event (used as idempotency
    key)

    - `webhook-timestamp`: Unix timestamp when the webhook was sent

    - `webhook-signature`: HMAC signature of the payload using your webhook
    secret


    ### Verification


    Use the [Standard Webhooks
    libraries](https://github.com/standard-webhooks/standard-webhooks) to verify
    webhook authenticity:


    ```go

    import (
        standardwebhooks "github.com/standard-webhooks/standard-webhooks/libraries/go"
    )

    wh, err := standardwebhooks.NewWebhookRaw(webhookSecret)

    err = wh.Verify(payload, headers)

    ```


    ```javascript

    import { Webhook } from 'standardwebhooks';


    const wh = new Webhook(webhookSecret);

    wh.verify(payload, headers);

    ```


    ```python

    from standardwebhooks.webhooks import Webhook


    wh = Webhook(webhook_secret)

    wh.verify(payload, headers)

    ```


    See the [verification
    documentation](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md#verifying-webhook-authenticity)
    for more implementation details.


    ### Retry Policy


    - Failed webhooks are retried **6 times** over **16+ minutes**

    - Only HTTP status codes **200-299** are considered successful

    - After **100 consecutive failures**, the webhook is automatically disabled

    - You'll receive an email notification when a webhook is disabled


    ### Payload Format


    All webhooks follow the Standard Webhooks payload structure:


    ```json

    {
      "type": "event.type",
      "timestamp": "2024-05-06T09:49:16.687031577Z",
      "data": {
        // Event-specific data
      }
    }

    ```


    ## Getting Started


    1. **Configure a webhook** in your AhaSend dashboard

    2. **Choose which events** you want to receive

    3. **Verify webhook signatures** using Standard Webhooks libraries

    4. **Handle the events** in your application


    For more information, visit the [AhaSend webhook
    documentation](https://ahasend.com/help/integrations/webhooks).
  version: 2.0.0
  contact:
    email: support@ahasend.com
  license:
    name: Proprietary
servers:
  - url: https://your-webhook-endpoint.com
    description: Your webhook endpoint URL (configured in AhaSend dashboard)
security: []
tags:
  - name: Message Events
    description: >
      Webhooks for outbound email delivery tracking.


      These events track the lifecycle of emails you send through AhaSend, from
      initial reception through final delivery or failure.
  - name: Suppression Events
    description: >
      Webhooks for email suppression list changes.


      These events notify you when email addresses are automatically added to
      your suppression list due to delivery issues.
  - name: Domain Events
    description: >
      Webhooks for domain configuration issues.


      These events alert you to DNS configuration problems that could prevent
      email delivery.
  - name: Route Events
    description: >
      Webhooks for inbound email processing.


      These events deliver inbound emails to your application for processing
      (e.g., support tickets, replies).
paths: {}

````