Webhooks

email.received

Fires when an inbound email arrives at one of your verified receiving domains. Carries metadata only.

The email.received event fires whenever MailBlastr receives an inbound email at one of your verified receiving domains.

For privacy and to support large attachments in serverless environments, the webhook carries metadata only — not the body, headers, or attachment bytes. Fetch the full message from the received emails API using data.email_id.

{
  "type": "email.received",
  "created_at": "2026-06-22T23:41:12.126Z",
  "data": {
    "email_id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
    "created_at": "2026-06-22T23:41:11.894719+00:00",
    "from": "sender@example.com",
    "to": ["inbox@example.com"],
    "bcc": [],
    "cc": [],
    "received_for": ["forwarded@example.com"],
    "message_id": "<111-222-333@email.example.com>",
    "subject": "Sending this example",
    "attachments": [
      {
        "id": "2a0c9ce0-3112-4728-976e-47ddcd16a318",
        "filename": "avatar.png",
        "content_type": "image/png",
        "content_disposition": "inline",
        "content_id": "img001"
      }
    ]
  }
}

Payload

typestringoptional

The event type that triggered the webhook.

created_atstringoptional

ISO 8601 timestamp when the webhook event was created.

dataobjectoptional

Event-specific data. The fields below live inside this object.

data.email_idstringoptional

Unique identifier for the received email. Use it to fetch the full message.

data.created_atstringoptional

ISO 8601 timestamp when the email was received.

data.fromstringoptional

Bare sender email address. The original display name is preserved on the retrieve endpoint.

data.tostring[]optional

Recipient address(es).

data.ccstring[]optional

Cc address(es).

data.bccstring[]optional

Bcc address(es).

data.received_forstring[]optional

Addresses the email was forwarded for, taken from the for clause of the message's Received headers.

data.message_idstringoptional

RFC Message-ID header value for the email.

data.subjectstringoptional

Email subject line.

data.attachmentsobject[]optional

Attachment metadata only — id, filename, content_type, content_disposition, content_id. Fetch the bytes separately.

The webhook never includes attachment bytes. Retrieve them from the received email's attachments endpoint using the attachment id.

This is one of several events MailBlastr can deliver. See the full list of webhook event types.