Done-for-you migrations are open: our consultants run yours. See the migration service

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 objectIn Zendesk SupportIn GorgiasIn FreshdeskIn FreshserviceIn KustomerIn PlainIn PylonIn LiveAgentIn HubSpot Service Hub
CustomersEnd-usersCustomersContactsRequestersCustomersCustomersContactsContactsContacts
TicketsTickets, with their replies, notes, files and original datesTickets, with their messages, notes, files and original datesTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fieldsTickets (incidents), with their messages as private notes, files and time entries; the original dates are in the notesConversations, 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

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Gorgias

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Freshdesk

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Freshservice

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Kustomer

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Plain

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into Pylon

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into LiveAgent

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

Into HubSpot Service Hub

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
GorgiasCustomers, TicketsNoNoNoNoNoYesYesNo

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

PermissionWhy Shuttio needs it
customers:read, tickets:readReads your customers (every email and phone channel) and your tickets with every message, internal note and attachment.
users:read, tags:read, custom_fields:readMatches agents and teams by name and email, and reads your tags and the definitions and values of your custom fields.
satisfaction_survey:read, macros:readReads the satisfaction score and comment of a ticket, and your macros (listed in the run; no Zendesk object takes them).
offlineKeeps 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.