​
Receiving Emails

A1Base can forward incoming emails to your application via webhooks. When an email is received at your A1Base email address, we’ll send a POST request to your configured webhook URL with the email details. You can configure your webhook on the email dashboard here

​
Webhook Payload

When an email is received, A1Base will send a POST request to your webhook endpoint with the following JSON payload:

{
    "email_id": "a82b3e6b-dc79-46ad-9284-a166629592e3",
    "subject": "Email Subject",
    "sender_address": "[email protected]",
    "recipient_address": "[email protected]",
    "timestamp": "2025-03-19T10:24:08.46083+00:00",
    "service": "email",
    "raw_email_data": "Full email content including headers and body"
}

​
Payload Fields

FieldTypeDescription
email_idstringUnique identifier for the received email
subjectstringSubject line of the email
sender_addressstringEmail address of the sender
recipient_addressstringYour A1Base email address that received the message
timestampstringISO 8601 timestamp of when the email was received
servicestringAlways “email” for email webhooks
raw_email_datastringComplete raw email content including headers and body

​
Example Raw Email Data

The raw_email_data field contains the complete email including headers, which you can parse to extract additional information like:

  • DKIM signatures
  • Message ID
  • Content type
  • Email body (plain text and HTML versions)
  • Attachments
  • Custom headers