Linking Gorgias as a source
Contents
This source is currently in alpha. The interface and available tables may change.
Enter your Gorgias credentials to pull your helpdesk data – tickets, messages, customers, users, and more – into the PostHog data warehouse.
Adding a data source
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Gorgias.
Next, gather your Gorgias credentials:
- Gorgias domain (subdomain) – your account subdomain, e.g.
your-companyforyour-company.gorgias.com. - Account email – the email of the account that owns the API key.
- API key – create one in your Gorgias account under Settings → REST API.
This source authenticates with HTTP Basic Auth (email plus API key) and requires read access to the endpoints you want to sync.
- Gorgias domain (subdomain) – your account subdomain, e.g.
Back in PostHog, enter the credentials and click Next.
Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using Gorgias data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
tickets | Support tickets | Full refresh |
messages | Messages on tickets | Full refresh |
customers | Customers | Full refresh |
users | Helpdesk users (agents) | Full refresh |
satisfaction_surveys | Customer satisfaction surveys | Full refresh |
tags | Tags | Full refresh |
views | Views | Full refresh |
teams | Teams | Full refresh |
macros | Macros | Full refresh |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Sync limitations
All Gorgias tables are full refresh only. Gorgias list endpoints have no server-side timestamp filter (only client-side ordering), so true incremental sync is not currently possible.
Configuration
| Option | Type | Required |
|---|---|---|
Gorgias domain (subdomain) | text | Yes |
Account email | Yes | |
API key | password | Yes |