---
title: Unified Emails API — Truto Unified API
slug: emails
canonical: "https://truto.one/unified-apis/emails/"
---

# Email Unified API

Integrate Email data across 3 providers with one API. 4 normalized resources, real-time pass-through, fully customizable.

**Base URL:** `https://api.truto.one/unified/emails`  
**Resources:** 4  
**Integrations:** 3

## Resources

### Attachments

Attachments are the files associated with an email. (9 fields)

- `id` (string) — The unique identifier for the attachment
- `file_name` (string) — The attachment's name.
- `email` (object) — The email to which the attachment belongs
- `size` (number) — The file size in bytes
- `file_url` (string) — The URL to download the attachment
- `content_type` (string) — The content type of the attachment
- `uploaded_by` (string) — The user who uploaded the attachment
- `created_at` (string) — The time when the attachment was created
- `updated_at` (string) — The time when the attachment was updated

### Emails

An email is a digital message sent and received electronically over the Internet. It typically contains a subject, sender, recipients, body content, and sometimes attachments. (17 fields)

- `id` (string) — The unique identifier for the email
- `from` (string) — Sender email address
- `to` (array) — Recipient email addresses
- `cc` (array) — CC email addresses
- `bcc` (array) — BCC email addresses
- `subject` (string) — Email subject
- `content` (object) — 
- `headers` (object) — Custom headers for the email
- `reply_to` (array) — Reply-to email address
- `priority` (string) — Priority of the email
- `folder` (object) — The folder where the email is stored
- `is_draft` (boolean) — Indicates whether the email is saved as a draft (created but not sent yet). If true, the email is still edited or waiting to be sent
- `attachments` (array) — The attachments of the email
- `urls` (array) — The email's urls
- `created_at` (string) — The date and time the email was created
- `updated_at` (string) — The date and time the email was last updated
- `sent_at` (string) — The date and time the email was sent

### Folders

The folder is a container used to organize and manage email messages. (8 fields)

- `id` (string) — The unique identifier for a folder
- `name` (string) — The name of the folder
- `folder_url` (string) — The URL of the folder
- `size` (integer) — The size of the folder
- `description` (string) — The description of the folder
- `parent` (object) — The folder where this folder belong
- `created_at` (string) — The date and time the folder was created
- `updated_at` (string) — The date and time the folder was last updated

### Users

Users represent the people using the underlying emails system. They are usually called agents, team members, admins, etc. (8 fields)

- `id` (string) — The unique identifier for a user
- `first_name` (string) — The first name of the user
- `last_name` (string) — The last name of the user
- `name` (string) — The name of the user
- `emails` (array) — The emails of the user
- `roles` (array) — The roles of the user
- `created_at` (string) — The date and time the user was created
- `updated_at` (string) — The date and time the user was last updated

## Supported integrations

- [Gmail](https://truto.one/integrations/detail/gmail/)
- [Google](https://truto.one/integrations/detail/google/)
- [Outlook Mail](https://truto.one/integrations/detail/outlook/)