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

Migrate into Freshdesk: where data lands, setup, limits

What Shuttio writes into Freshdesk, how it keeps the original dates and authors where the API allows, what can still email a customer and how to switch it off first, how to connect, what the Freshdesk API cannot do, and what a rollback leaves.

Last updated: 15 November 2026

Helpdesks that can move into Freshdesk: 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. Freshdesk to Freshdesk is not offered.

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

Source by source: Freshdesk support matrix.

Before you start

  • Freshdesk has no switch that stops a single API call from emailing the requester. In Admin > Email Notifications turn off the requester notifications (new ticket created, ticket solved, ticket closed, agent adds a comment), and pause any automation rule that fires when a ticket is created. Shuttio never uses the reply call, sets no CC address and moves tickets to their final status with the call that skips the closing email, but the new-ticket email is Freshdesk's own.
  • A ticket assigned to an agent notifies that agent: expect those emails.
  • If your account marks a field as required to close a ticket, turn that off while the import runs: otherwise the ticket stays Open and the run names it.
  • Create the agents you want to be assignees and note authors first: the Freshdesk API cannot create an agent without a licence and an invitation email, so Shuttio never does.

Connect

  • Paste your Freshdesk address (acme.freshdesk.com) and an administrator's API key from Profile Settings, View API Key. 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 account it first wrote to.
  • Custom fields, ticket time tracking and satisfaction surveys depend on your Freshdesk plan. What your plan refuses is written into the ticket's closing note instead of being lost.

What Shuttio writes

  • A ticket through the tickets API, with its subject, description (the first customer message), priority, channel, type (when your account has it), requester, assignee (matched by email), group, tags and custom values.
  • Every later message as a note that opens with its original time and author: an agent's reply is a private note written as the matching agent, a customer's message is an incoming note. Time entries and the rating are written when your plan allows.
  • Attachments are downloaded from the source and sent with the ticket or the note, up to 20 MB for one. A file that cannot be copied is named in its note.
  • Freshdesk takes no created or closed time: two custom date fields, Original created at and Original closed at, are added to your tickets, and the original time is the first line of every note.
  • Every imported ticket carries the tags imported_from_helpdesk, one for this migration and one that identifies the source ticket, so a retry never makes a second ticket.

Where each thing lands

FromObjectLands in Freshdesk as
FreshdeskCompaniesCompanies
FreshdeskContactsContacts
FreshdeskTicketsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
HubSpot Service HubCompaniesCompanies
HubSpot Service HubContactsContacts
HubSpot Service HubTicketsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
GorgiasCustomersContacts
GorgiasTicketsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
FreshserviceDepartmentsCompanies
FreshserviceRequestersContacts
FreshserviceTicketsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
KustomerCompaniesCompanies
KustomerCustomersContacts
KustomerConversationsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
PlainAccountsCompanies
PlainCustomersContacts
PlainThreadsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
PylonAccountsCompanies
PylonContactsContacts
PylonIssuesTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields
LiveAgentCompaniesCompanies
LiveAgentContactsContacts
LiveAgentTicketsTickets, with their messages as notes (an agent's are private), files, time entries and the original dates in custom fields

Matching, and what is never changed

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

What the Freshdesk API cannot do

  • It cannot write the original created, updated or closed time of a ticket or a note, or a due date in the past.
  • A reply call exists, but it emails the customer, so agent messages are private notes.
  • It cannot create an agent without a licence and an invitation, a user-type custom field, a product or an email configuration.
  • Customer-authored notes may refuse attachments: the note is written without them and names them.
  • It has no call that deletes a tag: the tags a rollback leaves are removed in Freshdesk settings.

Not answered here? Email help@shuttio.com.