Skip to main content

​
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:
FieldWhat is it?Where to find it
EmailYour Gorgias account emailYour login email
API KeySecure access keyGenerated in Step 1 below (save it immediately)
SubdomainYour unique Gorgias identifierFirst 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

The Sync Engine is currently in development and not yet deployed. This documentation is provided in advance of the feature release.
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: