Linking Gorgias as a source
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 |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
tickets | A customer support conversation in Gorgias, holding messages and metadata. | Incremental, Full refresh | updated_datetime | — |
messages | An individual message within a ticket (inbound or outbound). | Incremental, Full refresh | created_datetime | — |
customers | A customer (end user) who contacts support in Gorgias. | Incremental, Full refresh | updated_datetime | — |
users | An internal Gorgias user (support agent or admin). | Full refresh | — | — |
satisfaction_surveys | A customer satisfaction (CSAT) survey response tied to a ticket. | Incremental, Full refresh | created_datetime | — |
macros | A reusable canned response or action template used by agents. | Incremental, Full refresh | updated_datetime | — |
tags | A label that can be applied to tickets to categorize them. | Full refresh | — | — |
views | A saved, filtered view of tickets used to organize the agent workspace. | Full refresh | — | — |
teams | A team of agents in Gorgias used to route and assign tickets. | Full refresh | — | — |