Migrate from Kustomer: what moves, permissions, limits
What Shuttio reads from Kustomer, 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
An API key. You paste your Kustomer org (acme.kustomerapp.com) and a read-only key from Settings, Security, API Keys; Shuttio reads that org only.
Object by object: What objects are supported for Kustomer migrations.
What Shuttio reads and moves
The list below describes the move into Attio. Where Clarify or Odoo differ, the destination's own article says so.
- Companies: As Zendesk organizations, matched by name: one Zendesk already has is linked to, never changed. The name, domains, tags and custom attributes are read.
- Customers: As Zendesk end-users, matched by email: one Zendesk already has is linked to, never changed. Every email and phone, socials, addresses, company, tags and custom attributes are read.
- Conversations: Imported whole through Zendesk's ticket import with the original created time, status (done stays solved), customer, assigned user and team, priority, channel and tags. No customer is emailed and no trigger runs.
- Messages and notes: Every message in and out and every internal note, in order, with its time and author (the customer or the matching agent).
- Attachments: Downloaded from Kustomer through its temporary links and uploaded to Zendesk with the comment. A file that cannot be copied is named in the run's warnings.
- Tags and custom attributes: Conversation tags as Zendesk tags (a tag Kustomer returns only as an id moves as Kustomer tag <id>). Each conversation custom attribute is created in Zendesk when it has none of that name and type, and filled.
- Satisfaction result, SLA and first-response times: Kept as lines in the ticket's internal note: Zendesk has no field for them.
Where each thing lands
| Kustomer object | In Zendesk Support | In Gorgias | In Freshdesk | In Freshservice | In Kustomer | In Plain | In Pylon | In LiveAgent | In HubSpot Service Hub |
|---|---|---|---|---|---|---|---|---|---|
| Companies | Organizations | A Company field on each customer | Companies | Departments | Companies | Accounts | Accounts | Companies | Companies |
| Customers | End-users | Customers | Contacts | Requesters | Customers | Customers | Contacts | Contacts | Contacts |
| Conversations | 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 Kustomer, generated from the same tables the runner uses:
Into Zendesk Support
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Gorgias
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Freshdesk
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Freshservice
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Kustomer
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Plain
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into Pylon
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into LiveAgent
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | No | No | No | No | No | Yes | Yes | No |
Into HubSpot Service Hub
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| Kustomer | Companies, Customers, Conversations | 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
| What | Why Shuttio needs it |
|---|---|
| Your Kustomer org | Like acme.kustomerapp.com (or just acme), the name you sign in at. Shuttio accepts only kustomerapp.com hosts and sends the key nowhere else. The US, EU and India regions need nothing more. |
| An API key with these roles | Create it in Kustomer under Settings, Security, API Keys, Add API Key, and tick org.permission.customer.read, company.read, conversation.read, message.read, note.read, attachment.read, user.read and team.read (roles cannot be changed later). Optional: org.permission.metadata.read, klass.read and kobject.read, for the display names of custom attributes and the count of custom objects. Shuttio checks the key and its roles before it saves anything, and never writes to Kustomer as a source. |
Kustomer shares one request budget across every API key of your org (300 to 2,000 requests a minute depending on your plan); a large org takes hours, and the run pauses when Kustomer asks it to slow down until you resume it. The key is stored encrypted and deleted 14 days after the migration finishes. You can delete it at any time in Kustomer under Settings, Security, API Keys.
Known limits
- KObjects (custom objects): Zendesk's ticket import has no object for them. They are counted in the run summary and stay in Kustomer.
- Drafts, shortcuts, the knowledge base, workflows and SLAs: They are Kustomer settings or content, not records Zendesk's ticket import takes.
- Speed: Kustomer allows 300 to 2,000 requests a minute for the whole org depending on your plan, shared with every other key. A conversation takes about 4 calls plus one for each page of messages and notes, so a large org takes hours to days. Shuttio stays under the limit and pauses the run when Kustomer asks it to wait; Resume carries on.
- Emails: Shuttio reads no emails from this source.
Not answered here? Email help@shuttio.com.