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

Migrate into Kustomer: where data lands, setup, limits

What Shuttio writes into Kustomer, how it keeps the original dates and authors where the API allows, why no message is sent to a customer and what your own automations can still do, how to connect with the exact key roles, what the Kustomer API cannot do, and what a rollback leaves.

Last updated: 15 November 2026

Helpdesks that can move into Kustomer: Freshdesk, HubSpot Service Hub, Gorgias, Freshservice, Kustomer, Plain, Pylon, LiveAgent. A migration is free under 20,000 records in total: contacts, companies, deals, notes, activities and files together; otherwise it is priced by record count. The sample is free. See pricing. Kustomer to Kustomer is not offered.

Object by object: What objects are supported for Kustomer migrations.

Source by source: Kustomer support matrix.

Before you start

  • Kustomer's API records a message on the timeline and delivers nothing: an API-created message, in or out, is not emailed, texted or sent to chat. Shuttio never creates a draft, a forward or a chat call and adds no @mention. What can still reach a customer is your own automation reacting to the new records.
  • Pause the workflows and business rules that fire on a new conversation or message (auto-replies, routing that sends a message), and turn off the satisfaction survey Kustomer sends when a conversation is marked Done. Shuttio cannot switch them off for you.
  • A conversation assigned to a user notifies that user: expect those emails.
  • Create the users you want to be assignees and note authors first: the Kustomer API invites a user with a seat and an email, so Shuttio never creates one. Custom attributes and teams are created on the way.

Connect

  • Paste your Kustomer org (acme.kustomerapp.com, or just acme) and an API key from Settings, Security, API Keys. The US, EU and India regions need nothing more. There is no OAuth and no app to install. The key is stored encrypted and deleted 14 days after the migration finishes. A migration is pinned to the org it first wrote to.
  • Tick exactly these roles when you create the key (roles cannot be changed later): org.permission.customer.read, customer.create, company.read, company.create, conversation.read, conversation.create, conversation.update, message.read, message.create, note.read, note.create, user.read, team.read, team.create.
  • Also tick, to set display names and to allow a Cancel: org.permission.metadata.read, metadata.update, conversation.delete, customer.delete, team.delete.
  • Tick org.admin to keep original created times and authors: Kustomer lets only a key with that role set createdAt and createdBy. Without it, each note and reply opens with its original author and time and the original created time is a custom date attribute. A message's original sent time is written either way.

What Shuttio writes

  • A conversation with its subject, status (Done when solved or closed, set last), priority (1 to 5), assigned user and team (matched by email and name), tags and custom attributes, marked with importedAt.
  • Every message, the first included, as a message record with its original sent time, direction and channel. The text is plain: HTML formatting is lost. A text over 10,240 characters continues in a further record.
  • Internal notes with their original author and time when the key may set them. Attachments are downloaded from the source and uploaded to Kustomer (up to 25 MB a message); a file that cannot be copied is named in its message.
  • Custom fields as custom attributes, named from the label and typed by the field (text, number, date, checkbox); owners as the owner's email in a text attribute.
  • Every record carries an external id, so a retry never makes a second one.

Where each thing lands

FromObjectLands in Kustomer as
FreshdeskCompaniesCompanies
FreshdeskContactsCustomers
FreshdeskTicketsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
HubSpot Service HubCompaniesCompanies
HubSpot Service HubContactsCustomers
HubSpot Service HubTicketsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
GorgiasCustomersCustomers
GorgiasTicketsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
FreshserviceDepartmentsCompanies
FreshserviceRequestersCustomers
FreshserviceTicketsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
KustomerCompaniesCompanies
KustomerCustomersCustomers
KustomerConversationsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
PlainAccountsCompanies
PlainCustomersCustomers
PlainThreadsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
PylonAccountsCompanies
PylonContactsCustomers
PylonIssuesConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)
LiveAgentCompaniesCompanies
LiveAgentContactsCustomers
LiveAgentTicketsConversations, with their messages, notes, files and the original dates and authors (when the key has the org.admin role)

Matching, and what is never changed

  • A customer whose email, or a company whose name, Kustomer already has is linked to and never written or removed. A rollback does not remove it.

What the Kustomer API cannot do

  • It lets only an org.admin key set the original created time and author of a record.
  • It writes no satisfaction answer, no time entry and no SLA state: they are lines in the conversation's closing note.
  • It has no call that deletes a company or a tag: after a rollback the companies Shuttio created stay, and so do the tags and custom attribute definitions.
  • A message is plain text: formatting and the place of an inline image are lost.

Not answered here? Email help@shuttio.com.