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

# Email message

> The email message object represents a single email within a thread.

An email message is an individual email sent or received. Each message has a sender, recipients, subject, body, and metadata about its type and status.

## Fields

<ParamField path="id" type="string (uuid)" required>
  Unique identifier for the email message.
</ParamField>

<ParamField path="objectType" type="string" required>
  Always `email_message`.
</ParamField>

<ParamField path="emailThreadId" type="string (uuid)">
  The ID of the email thread this message belongs to.
</ParamField>

<ParamField path="subject" type="string" required>
  The email subject line.
</ParamField>

<ParamField path="body" type="string" required>
  The email body content.
</ParamField>

<ParamField path="from" type="ContactInfo | null">
  The sender of the email. See [ContactInfo](#contactinfo) below.
</ParamField>

<ParamField path="type" type="string">
  The type of the email message. One of `manual`, `campaign`, `reply_agent`, or `received`.
</ParamField>

<ParamField path="status" type="string">
  The status of the email message. One of `sent` or `draft`.
</ParamField>

<ParamField path="prospectId" type="string (uuid)">
  The ID of the prospect associated with this message.
</ParamField>

<ParamField path="repId" type="string (uuid)">
  The ID of the rep associated with this message.
</ParamField>

<ParamField path="recipients" type="object" required>
  The email recipients, broken down by type.

  <Expandable title="recipients properties">
    <ParamField path="recipients.to" type="ContactInfo[]" required>
      Primary recipients.
    </ParamField>

    <ParamField path="recipients.cc" type="ContactInfo[]">
      CC recipients.
    </ParamField>

    <ParamField path="recipients.bcc" type="ContactInfo[]">
      BCC recipients.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="sentAt" type="string (date-time)" required>
  Timestamp when the email was sent.
</ParamField>

<ParamField path="createdAt" type="string (date-time)" required>
  Timestamp when the email message record was created.
</ParamField>

<ParamField path="updatedAt" type="string (date-time)" required>
  Timestamp when the email message record was last updated.
</ParamField>

### ContactInfo

The contact info object is used for email senders and recipients.

<ParamField path="name" type="string" required>
  Display name of the contact.
</ParamField>

<ParamField path="email" type="string" required>
  Email address of the contact.
</ParamField>

## Example

```json theme={null}
{
  "id": "e8f9a0b1-c2d3-4567-890a-bcdef1234567",
  "objectType": "email_message",
  "emailThreadId": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "subject": "Quick follow-up on our conversation",
  "body": "Hi Jane, just wanted to follow up on our call last week...",
  "from": {
    "name": "Alex Johnson",
    "email": "alex@altahq.com"
  },
  "type": "manual",
  "status": "sent",
  "prospectId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "repId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "recipients": {
    "to": [
      {
        "name": "Jane Smith",
        "email": "jane.smith@acme.com"
      }
    ],
    "cc": [],
    "bcc": []
  },
  "sentAt": "2024-01-18T14:20:00Z",
  "createdAt": "2024-01-18T14:20:00Z",
  "updatedAt": "2024-01-18T14:20:00Z"
}
```

## Used in

* [List email messages](/api-reference/email-messages/list) - returns an array of email message objects
* [Get an email message](/api-reference/email-messages/get) - returns a single email message object