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

# Set Up Email to Ticket

> Automatically convert forwarded client emails into support tickets by connecting your support inbox to your AgencyHandy workspace forwarding address.

The **Email to Ticket** feature automatically converts client emails into support tickets. Once your support email is configured to forward incoming emails to your unique AgencyHandy forwarding address, every new email from a recognized client automatically creates a ticket in your workspace.

<Note>
  Only emails sent from existing client email addresses create tickets automatically.
</Note>

***

## Accessing Email to Ticket

<Steps>
  <Step title="Open Workspace Config">
    Log in to AgencyHandy. In the left navigation menu, click **Workspace Config**.
  </Step>

  <Step title="Select Email to Ticket">
    Click **Email to Ticket** from the Workspace Config submenu.
  </Step>
</Steps>

From this page, you can:

* Get your unique forwarding address.
* Configure email forwarding.
* Verify your forwarding setup.
* Enable automatic ticket creation.
* View setup instructions for different email providers.

<img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/overview-page.png?fit=max&auto=format&n=5J48F9EuLX9_RStI&q=85&s=ff2ba454b14925a58aaf3af6ccae8cff" alt="Email to Ticket settings page" width="1892" height="868" data-path="images/email-to-ticket/overview-page.png" />

<p style={{textAlign: 'center'}}>*Email to Ticket settings page*</p>

***

## Your workspace forwarding address

AgencyHandy generates a unique forwarding email address for every workspace. This address receives forwarded emails from your support inbox.

<Steps>
  <Step title="Copy your forwarding address">
    Click **Copy** to copy your workspace forwarding address.
  </Step>

  <Step title="Add it as a forwarding destination">
    Add this address as a forwarding destination in your email provider.
  </Step>

  <Step title="Complete verification">
    Complete the forwarding verification process required by your provider.
  </Step>

  <Step title="Enable Auto-create Ticket">
    Once verification is complete, enable **Auto-create Ticket**.
  </Step>
</Steps>

<img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/forwarding-address-copy.png?fit=max&auto=format&n=5J48F9EuLX9_RStI&q=85&s=d4d7e316f084e35064c3f99f3c103f92" alt="Workspace forwarding address with Copy button" width="1341" height="515" data-path="images/email-to-ticket/forwarding-address-copy.png" />

<p style={{textAlign: 'center'}}>*Workspace forwarding address with Copy button*</p>

<Tip>
  Your forwarding address is unique to your workspace and remains the same unless you regenerate it.
</Tip>

***

## Setting up email forwarding

AgencyHandy does not access your mailbox. Email forwarding is configured entirely within your email provider.

The Email to Ticket page includes setup guides for:

* Gmail
* Outlook / Microsoft 365
* Zoho Mail
* cPanel / Hosting
* Other providers that support email forwarding

Select your email provider on the Email to Ticket page to view the appropriate setup instructions.

***

## Gmail setup

If you use Gmail, follow these steps.

<Steps>
  <Step title="Open Gmail forwarding settings">
    In Gmail, go to **Settings → See all settings → Forwarding and POP/IMAP**.

    <img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/gmail-forwarding-settings.gif?s=018e8917aa711ffac7dc9201507ad856" alt="Gmail Forwarding and POP/IMAP settings tab" width="1920" height="1080" data-path="images/email-to-ticket/gmail-forwarding-settings.gif" />

    <p style={{textAlign: 'center'}}>*Gmail Forwarding and POP/IMAP settings tab*</p>
  </Step>

  <Step title="Add the AgencyHandy forwarding address">
    Click **Add a forwarding address** and paste the forwarding address you copied from AgencyHandy. Google sends a confirmation email to verify the forwarding address. Return to AgencyHandy after saving the forwarding address.

    <img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/gmail-add-forwarding-address.gif?s=ff52342f9ccaf22a8179139b5801ced2" alt="Gmail Add a forwarding address dialog" width="1920" height="1080" data-path="images/email-to-ticket/gmail-add-forwarding-address.gif" />

    <p style={{textAlign: 'center'}}>*Gmail Add a forwarding address dialog*</p>
  </Step>

  <Step title="Verify the forwarding address">
    Return to **Workspace Config → Email to Ticket** and click **I've added the address in Gmail**. AgencyHandy waits for Google's confirmation email and automatically detects the confirmation link or verification code when it arrives, usually within one to two minutes. Once verification is complete, the forwarding setup is ready.

    <img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/gmail-verify-forwarding.gif?s=236c8480f9ffbacc71091414f949df99" alt="Verifying the forwarding address in AgencyHandy" width="1280" height="720" data-path="images/email-to-ticket/gmail-verify-forwarding.gif" />

    <p style={{textAlign: 'center'}}>*Verifying the forwarding address in AgencyHandy*</p>
  </Step>

  <Step title="Forward incoming emails">
    In Gmail:

    * Enable **Forward a copy of incoming mail**.
    * Select your AgencyHandy forwarding address.
    * Save your changes.

    All future emails received by your support inbox are now forwarded to AgencyHandy.

    <img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/gmail-forward-incoming-mail.gif?s=616e6942702ffd79c5bdda53d392cdac" alt="Gmail Forward a copy of incoming mail option" width="1920" height="1080" data-path="images/email-to-ticket/gmail-forward-incoming-mail.gif" />

    <p style={{textAlign: 'center'}}>*Gmail Forward a copy of incoming mail option*</p>
  </Step>
</Steps>

***

## Auto-create Ticket

After forwarding has been verified, enable the **Auto-create Ticket** toggle.

When enabled:

* Every forwarded email from an existing client automatically creates a new support ticket.
* Clients are matched using their email address.
* A success message confirms that Email to Ticket is active.

<img src="https://mintcdn.com/agencyhandy-36ccbd64/5J48F9EuLX9_RStI/images/email-to-ticket/auto-create-ticket-toggle.png?fit=max&auto=format&n=5J48F9EuLX9_RStI&q=85&s=18cfaf8cccbd63eefd3fb5914e14638a" alt="Auto-create Ticket toggle enabled" width="1338" height="206" data-path="images/email-to-ticket/auto-create-ticket-toggle.png" />

<p style={{textAlign: 'center'}}>*Auto-create Ticket toggle enabled*</p>

<Warning>
  Keep this option disabled until forwarding verification has been completed.
</Warning>

***

## Confirmation helper

For supported email providers, AgencyHandy includes a confirmation helper. After adding the forwarding address in your email provider:

1. Return to the Email to Ticket page.
2. Click the confirmation button, such as **I've added the address in Gmail**.
3. Wait while AgencyHandy checks for the provider's verification email.
4. Once detected, AgencyHandy automatically completes the verification process.

This removes the need to manually retrieve the verification email or confirmation code.

***

## Refresh verification status

If verification is taking longer than expected, click **Refresh** to check for newly received confirmation emails.

***

## How Email to Ticket works

Once Email to Ticket is configured:

1. A client sends an email to your support email address.
2. Your email provider automatically forwards a copy of the email to your AgencyHandy forwarding address.
3. AgencyHandy verifies the sender's email address.
4. If the sender matches an existing client in your workspace, a new ticket is automatically created.

***

## Notes

* Only emails from existing client email addresses create tickets automatically.
* Emails from unknown senders are ignored.
* Each workspace has its own unique forwarding address.
* AgencyHandy only receives forwarded copies of emails. It does not access your mailbox directly.
* Email reply threading is planned for a future release.