Email Message

An Email Message is a record of an email sent or received through AM’s email infrastructure.

Schema

interface EmailMessage {
  id: string; // "eml_..." - Unique identifier
  account_id: string; // Owning account
  hostname: string; // Sending domain
  direction: "in" | "out"; // Inbound or outbound
  from_contact: EmailContact;
  reply_to_contacts: EmailContact[];
  to_contacts: EmailContact[];
  cc_contacts: EmailContact[];
  bcc_contacts: EmailContact[];
  subject: string;
  body_text: string;
  body_html: string;
  received_at: string | null;
  sent_at: string | null;
}

interface EmailContact {
  email: string;
  name?: string;
}

Properties

Property	Type	Description
`id`	`string`	KSUID with `eml_` prefix
`account_id`	`string`	Account that owns message
`hostname`	`string`	Domain used for sending
`direction`	`enum`	`in` for received, `out` for sent
`from_contact`	`object`	Sender information
`reply_to_contacts`	`array`	Reply-to contacts
`to_contacts`	`array`	Primary recipients
`cc_contacts`	`array`	CC recipients
`bcc_contacts`	`array`	BCC recipients
`subject`	`string`	Email subject line
`body_text`	`string`	Plain text content
`body_html`	`string`	HTML content
`received_at`	`string?`	When inbound email was received
`sent_at`	`string?`	When outbound email was sent

Example

{
  "id": "eml_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "hostname": "mail.example.com",
  "direction": "out",
  "from_contact": {
    "email": "noreply@example.com",
    "name": "Acme Corp"
  },
  "reply_to_contacts": [],
  "to_contacts": [{ "email": "user@example.com", "name": "Jane Doe" }],
  "cc_contacts": [],
  "bcc_contacts": [],
  "subject": "Welcome to Acme",
  "body_text": "Welcome...",
  "body_html": "<h1>Welcome</h1>...",
  "sent_at": "2025-01-15T10:30:00Z"
}

Email Message Event - Delivery tracking
Email Template - Reusable templates
Email - Email infrastructure

Email Message

Schema

Properties

Example

Related