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

# Emails

Includes all emails tracked in Affinity with sender, recipients, subject, and direction information.

**Name:** `v1_0.emails`

Deleted and merged records are covered in [Deletes & Merges](https://developer.affinity.co/pages/data-share/deletes.md).

> [!WARNING]
>
> Grant access to the share only to users who are authorized to view all
> organization data. There are no per-user or per-role visibility filters applied at the
> share level.

## Columns

| Column | Description |
| - | - |
| `id` | The email's unique identifier |
| `logging_type` | Indicates how the interaction was added to Affinity: either manually by a user ('manual') or automatically through Affinity's capture process ('automated'). Currently, emails can only be logged as 'automated'. |
| `subject` | The email's subject line. NULL unless an Affinity admin chose 'Include email subject lines' for this share under Settings > Integrations. Also NULL when a participant's privacy settings withhold it. |
| `direction` | The direction of the email: 'sent' if the email was sent by an internal user and 'received' if the email was sent to an internal user |
| `sent_at` | The timestamp of when the email was sent |
| `created_at` | The timestamp of when the email was created in Affinity |
| `from` | The email address of the participant who sent the email |
| `to_participants` | Array of email addresses in the To field |
| `cc_participants` | Array of email addresses in the CC field |
| `is_deleted` | Whether the email record has been deleted |
| `last_updated_at` | Timestamp when this record was last updated |


## Related topics

- [Emails Companies](https://developer.affinity.co/pages/data-share/emails_companies_v1_0.md)
- [Emails Persons](https://developer.affinity.co/pages/data-share/emails_persons_v1_0.md)
- [Notes Emails](https://developer.affinity.co/pages/data-share/notes_emails_v1_0.md)
- [Get metadata on all Emails](https://developer.affinity.co/api-reference/2024-01-01/emails/get-metadata-on-all-emails.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.