Migrate from Gorgias: what moves, permissions, limits
What Shuttio reads from Gorgias, where it lands in Zendesk Support, Gorgias, Freshdesk and 6 more, which permissions it needs and why, and what does not move.
Last updated: 15 November 2026
Sign in with Gorgias (OAuth, read access) after you type your subdomain, or paste an email and an API key as the fallback. Shuttio reads that account only.
Object by object: What objects are supported for Gorgias migrations.
What Shuttio reads and moves
The list below describes the move into Zendesk Support. Where Clarify or Odoo differ, the destination's own article says so.
- Customers: As Zendesk end-users, matched by email: one Zendesk already has is linked to, never changed. Every email and phone channel is read; the first email is the login, the others become identities, and other phones, social handles and custom fields go in the user's notes.
- Tickets: Imported whole through Zendesk's ticket import with the original created, last updated and closed times, status, priority, channel, requester, assignee, group and tags. No customer is emailed and no trigger runs.
- Messages: Every message, in order: each public reply with its time and author (the customer or the matching agent), each internal note as a private comment, with its HTML and text.
- Attachments and inline images: Downloaded from Gorgias and uploaded to Zendesk, and an inline image in a message points at its copy. A file that cannot be copied is named in the message and in the run's warnings.
- Tags and custom fields: Ticket tags as Zendesk tags. Each custom ticket field is created in Zendesk when it has none of that name and type, and filled; a value that does not fit goes in the ticket's internal note. Customer fields go in the end-user's notes.
- Teams and agents: A team becomes a Zendesk group (created when missing). An assignee or a message author is matched to a Zendesk agent by email; one with no agent is named in the ticket's internal note.
- Satisfaction surveys: The score (1 to 5) and the comment are kept as a tag and a line in the ticket's internal note: Zendesk lets only the requester rate a ticket.
- Status, snooze, spam and trash: Open and closed tickets keep their status; a snoozed ticket opens and says so in its note. Tickets in Gorgias's trash or marked as spam are not imported, and the run counts them.
Where each thing lands
| Gorgias object | In Zendesk Support | In Gorgias | In Freshdesk | In Freshservice | In Kustomer | In Plain | In Pylon | In LiveAgent | In HubSpot Service Hub |
|---|---|---|---|---|---|---|---|---|---|
| Customers | End-users | Customers | Contacts | Requesters | Customers | Customers | Contacts | Contacts | Contacts |
| Tickets | Tickets, with their replies, notes, files and original dates | Tickets, with their messages, notes, files and original dates | Tickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields | Tickets (incidents), with their messages as private notes, files and time entries; the original dates are in the notes | Conversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role) | Threads, with their messages as imported inbound and outbound messages, notes, files and the original dates and authors (an agent with no Plain user of that email is named in the first line) | Issues with the original created date, and every message as an internal note with its files and the original author and time in its first line (Pylon sets no time or author on a note) | Tickets, each with every message after the first as an internal note with its files and the original author and time in its first line (LiveAgent sets no time on a ticket or a note) | Tickets, with their emails, notes, files and original dates |
Notes, tasks, meetings, calls, files, owners and lists depend on the destination. This is the row for Gorgias, generated from the same tables the runner uses:
Into Zendesk Support
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Gorgias
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Freshdesk
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Freshservice
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Kustomer
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Plain
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into Pylon
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into LiveAgent
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Into HubSpot Service Hub
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Gorgias | Customers, Tickets | No | No | No | No | No | Yes | Yes | No |
Each destination's own article says how its data is written: Zendesk Support, Gorgias, Freshdesk, Freshservice, Kustomer, Plain, Pylon, LiveAgent, HubSpot Service Hub.
Permissions and why
| Permission | Why Shuttio needs it |
|---|---|
| customers:read, tickets:read | Reads your customers (every email and phone channel) and your tickets with every message, internal note and attachment. |
| users:read, tags:read, custom_fields:read | Matches agents and teams by name and email, and reads your tags and the definitions and values of your custom fields. |
| satisfaction_survey:read, macros:read | Reads the satisfaction score and comment of a ticket, and your macros (listed in the run; no Zendesk object takes them). |
| offline | Keeps the sign-in alive for a long run without asking you again. |
You type your Gorgias subdomain (acme for acme.gorgias.com) and sign in as an admin who can see the tickets you are moving. Shuttio never writes to Gorgias. The access lasts 24 hours and is renewed; connecting again replaces it. Without the sign-in you can paste an email and an API key instead: Gorgias limits a key to 40 requests per 20 seconds, half of what the sign-in gets. You can remove Shuttio at any time in Gorgias under Settings, App Store, My apps; Gorgias documents no way for Shuttio to revoke the access, so Shuttio deletes its copy 14 days after the migration finishes.
Known limits
- Organizations: Gorgias has none, so no company is created and no end-user is linked to one.
- Rules, views, macros, integrations, widgets, statistics and ticket events: They are Gorgias settings, not records Zendesk's ticket import takes. Macros are read and listed in the run, but no Zendesk object takes them.
- Customer integration data: The Shopify and other integration data Gorgias shows beside a customer is not copied.
- Edits to older records on a delta: Gorgias lists records by created time only, so a delta moves records created after the last run and does not see changes to older ones.
- SLA and reply-time numbers: Zendesk keeps none for imported tickets.
- Rate limits: Gorgias allows 80 requests per 20 seconds for an app sign-in and 40 for an API key. Shuttio stays under them and pauses the run if Gorgias still pushes back; Resume carries on.
- Emails: messages that arrived by email are read as messages of their ticket; Shuttio reads no mailbox.
Not answered here? Email help@shuttio.com.