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

# Email

The Email connection allows you to connect external mailboxes and sync emails into SeaTicket as structured items your team can view and act on.

This guide uses Gmail as an example.

## Before You Start

Ensure you have the following:

* An **App Password** generated from your email provider. This is required instead of your regular account password. Refer to official guide of your email provider for instructions on generating an app password.

## Creating an Email Connection

1. Go to **Connections** in the left sidebar.
2. Click **+ New Connection** in the top-right corner.
3. Select **Emails** as the connection type.
4. Click **Next**.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/WcHiqSPczPbRTQJs/images/image-331.png?fit=max&auto=format&n=WcHiqSPczPbRTQJs&q=85&s=91cd8d65479b8c36e0e5101ee6af1316" alt="Image" width="1887" height="881" data-path="images/image-331.png" />
</Frame>

5. Fill in the configuration fields:

**Basic Information**

| Field                              | Description                                                          |
| :--------------------------------- | :------------------------------------------------------------------- |
| **Connection name**                | A name to identify this connection (e.g., Gmail <br />Support Inbox) |
| **Server provider**                | Select the authentication mode for your email provider               |
| **"From" display name** (optional) | The sender name displayed in outgoing emails                         |
| **"From" address** (optional)      | The email address used as the sender                                 |

**Server Settings**

| Field                    | Example                                 |
| :----------------------- | :-------------------------------------- |
| **SMTP host**            | [smtp.gmail.com](http://smtp.gmail.com) |
| **SMTP port**            | 587                                     |
| **IMAP host** (optional) | [imap.gmail.com](http://imap.gmail.com) |
| **IMAP port**            | 993                                     |

**Authentication**

| Field        | Description                                                                                                                                                                                                                                                           |
| :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Username** | Your full email address                                                                                                                                                                                                                                               |
| **Password** | Your App Password — not your regular email password<br />[Refer to Google's official guide for instructions on ](https://support.google.com/accounts/answer/185833?hl=en)<br />[generating an app password](https://support.google.com/accounts/answer/185833?hl=en). |

**Sync Settings**

| Field                                                              | Description                                                     |
| :----------------------------------------------------------------- | :-------------------------------------------------------------- |
| **Only sync emails within the following**<br />**number of years** | Limits how far back SeaTicket <br />retrieves historical emails |

<img src="https://mintcdn.com/seacloud-labs/P273-RPgjYaMnI7f/images/image-245.png?fit=max&auto=format&n=P273-RPgjYaMnI7f&q=85&s=160f49162dbd2baef48fc5df5fb493e4" alt="Image" width="563" height="723" data-path="images/image-245.png" />

6. Click **Submit** to complete the setup

## After the Connection is Created

Once created, the connection appears on the Connections page. The sync status will show as **Pending** while SeaTicket performs the initial synchronization. Once complete, the status updates to **Completed** and the last synced time is recorded.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/P273-RPgjYaMnI7f/images/image-243.png?fit=max&auto=format&n=P273-RPgjYaMnI7f&q=85&s=6a44e77f65ef4e1237fce9c0d373a358" alt="Image" width="1887" height="782" data-path="images/image-243.png" />
</Frame>

<Note>
  * Emails are automatically synced every 1 hour.
  * Initial synchronization may take time depending on mailbox size
  * Ensure your email provider allows IMAP/SMTP access
  * If synchronization fails, check authentication settings or server configuration
</Note>

## Viewing Synced Emails

Once synced, emails appear in a list view under the connection. For each email, SeaTicket records the subject, last modified time, and unread status. SeaTicket also automatically generates an AI summary and records when that processing was completed.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/4TyNjwQahwpPq75X/images/image-263.png?fit=max&auto=format&n=4TyNjwQahwpPq75X&q=85&s=2b412697698048499bd59de4e5bb3ce9" alt="Image" width="1856" height="787" data-path="images/image-263.png" />
</Frame>

After data has been synced, Click any email title to open the full email thread, including all replies and conversation history.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/VpSMHVL7sZs2hr1x/images/image-264.png?fit=max&auto=format&n=VpSMHVL7sZs2hr1x&q=85&s=cc1b31bd91723aca5d436843556a259a" alt="Image" width="1645" height="715" data-path="images/image-264.png" />
</Frame>
