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

# Gorgias Connector

> Sync tickets and messages from Gorgias to cxconnect.ai

## Overview

The **Gorgias Connector** automatically syncs your customer support tickets and messages from Gorgias to cxconnect.ai.

## What Data is Synced

The connector will sync the following information from your Gorgias account:

* **Tickets**: Customer support tickets including subject, description, status, priority, and customer details
* **Messages**: All messages within each ticket, including both customer messages and agent replies

## Prerequisites

Before you begin, make sure you have:

1. Administrator access to your Gorgias account
2. Your Gorgias subdomain (the first part of your Gorgias URL)

## Required Information

You'll need to provide the following when setting up the connector:

| Field     | What is it?                    | Where to find it                                                    |
| --------- | ------------------------------ | ------------------------------------------------------------------- |
| Email     | Your Gorgias account email     | Your login email                                                    |
| API Key   | Secure access key              | Generated in Step 1 below (save it immediately)                     |
| Subdomain | Your unique Gorgias identifier | First part of your URL (e.g., `company` from `company.gorgias.com`) |

## Setup Instructions

### Step 1: Generate API Key in Gorgias

1. Log in to your Gorgias account as an administrator
2. Go to **Settings** > **REST API**
3. Click **Create API Key**
4. Give it a name: `cxconnect.ai Sync`
5. Make sure it has read access to tickets and messages
6. Click **Create**
7. **Important**: Copy the API Key immediately - you won't be able to see it again

### Step 2: Find Your Subdomain

Look at your Gorgias URL to find your subdomain:

* If your URL is `https://company.gorgias.com`, your subdomain is `company`
* If your URL is `https://acme-support.gorgias.com`, your subdomain is `acme-support`

### Step 3: Connect in cxconnect.ai Admin Portal

1. Log in to the cxconnect.ai Admin Portal
2. Go to **Sync Connectors** > **Add Connector**
3. Select **Gorgias**
4. Enter your information:
   * **Email**: Your Gorgias account email
   * **API Key**: Copy from Step 1
   * **Subdomain**: From Step 2
5. Click **Test Connection** to make sure everything is set up correctly
6. Click **Save & Activate** to start syncing

### Step 4: Monitor Your Sync

<Note>
  The Sync Engine is currently in development and not yet deployed. This documentation is provided in advance of the feature release.
</Note>

Once activated, the connector will automatically sync your data:

* Initial sync may take some time depending on ticket volume
* Monitor progress in the Admin Portal dashboard
* Check sync logs for any issues

## Troubleshooting

### Connection Issues

**Problem**: Unable to connect or authenticate

**What to check**:

* Verify your email and API key are entered correctly
* Make sure the API key hasn't been deleted or revoked in Gorgias
* Check that your subdomain is spelled correctly (just the subdomain part, not the full URL)
* Ensure your Gorgias account is active

### Missing Messages

**Problem**: Tickets sync but some messages are missing

**What to check**:

* Verify the API key has read permissions for messages
* Check that the messages exist in Gorgias
* Contact support if data consistently appears to be missing

### Wrong Subdomain

**Problem**: Connection fails with "not found" error

**What to check**:

* Make sure you're using only the subdomain (e.g., `company`, not `company.gorgias.com`)
* Double-check spelling of your subdomain
* Verify you're using the correct Gorgias account

## Need Help?

If you're still experiencing issues:

* **Email Support**: [help@cxconnect.ai](mailto:help@cxconnect.ai)
* **Gorgias Documentation**: [Gorgias Help Center](https://docs.gorgias.com)