Reference

EmailMessage

Type
One outbound message and its delivery lifecycle, from queued to bounced.

One outbound message and its lifecycle. status says where it got to, diagnostic carries the provider’s bounce reason, and batchId links it to a blast. kind separates your sendEmail calls from platform sign-in codes.

EmailMessage.ts
interface EmailMessage {
  id: string
  recipient: string
  status: EmailMessageStatus
  kind: 'method' | 'auth'
  subject: string | null
  batchId: string | null
  diagnostic: Record<string, unknown> | null
  sentAt: string | null
  createdAt: string
}
Fields
id
string
The message id.
recipient
string
The destination address.
Where the message got to.
kind
'method' | 'auth'
Your sendEmail calls, or platform sign-in codes.
subject
string | null
The subject line, if any.
batchId
string | null
The blast this belonged to, if any.
diagnostic
Record<string, unknown> | null
Provider diagnostics; the SMTP reason on a bounce.
sentAt
string | null
When the provider accepted it.
createdAt
string
When the row was created.