# Set Up the Email Connector

The Email Connector allows you to ingest individual emails and their attachments into your project. To use the connector, you will forward selected emails to a unique, dedicated email address generated for your data source.

> ⚠️ Warning: Emails with empty fields for **From**, **To**, or **Subject** are considered spam and will not be ingested.

## Setting Up the Connector

1.  **Select Email Data Source**
    Navigate to the **Data Sources** section of your project. Click **Add data source** and select **Email** from the available library.
2.  **Generate Forwarding Email Address**
    A unique forwarding email address will be automatically generated for this specific data source. **Copy this email address immediately**, as it will be your target for forwarding emails you wish to ingest.
    Click **Done** to finalize the data source setup.
    > 💡 Note: You can find this generated email address later by editing the data source details.
3.  **Forward Emails for Ingestion**
    To start ingesting emails, forward them to the email address copied in the previous step. You can achieve this in two ways:
    *   **Manually**: Send emails one by one to the generated address.
    *   **Programmatically**: Set up a forwarding rule in your mailbox to automatically forward emails for ingestion. For more information on how to do that, check the user guides provided by your email provider.
        *   For **Gmail**: Refer to [Automatically forward Gmail messages to another account](https://support.google.com/mail/answer/10957?hl=en).
        *   For **Outlook**: Refer to [Use rules to automatically forward messages](https://support.microsoft.com/en-us/office/use-rules-to-automatically-forward-messages-5acb0104-a63e-4286-9a22-8dd0e1183377).
    > 💡 Note: If you encounter issues with forwarding, check your organization’s email forwarding policy.
4.  **View Ingestion Status**
    Once you start forwarding emails, you can view the ingestion status by clicking on the data source. You will see a list of all ingested emails and their attachments.
    *   Attachments are listed with their original name and file type.
    *   The body of an email is captured under a newly generated name, typically formatted as `[subject]email[timestamp]`, where `[subject]` is the email's subject and `[timestamp]` is the time the email was received.
    > 💡 Note: Ingestion can be a time-consuming operation, so you may need to refresh the page to see the updated status.

## Next Steps

After your data has been successfully ingested, the Email data source is ready to be used with an Agent.
