Migrate into LiveAgent: where data lands, setup, limits
What Shuttio writes into LiveAgent, why every message after the first is an internal note with the original author and time in its first line, what LiveAgent's own automation rules can still do, how to connect with an API v3 key, what the LiveAgent API cannot do, and what a rollback leaves.
Last updated: 15 November 2026
Helpdesks that can move into LiveAgent: 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. LiveAgent to LiveAgent is not offered.
Object by object: What objects are supported for LiveAgent migrations.
Source by source: LiveAgent support matrix.
Before you start
- Shuttio contacts no customer. A ticket is created with no mail and no template, and every message after the first is an internal note, because a LiveAgent agent reply is emailed to the customer. A ticket's status is set when it is created and never changed afterwards, because a status change can fire a rule that mails the customer.
- LiveAgent's own automation rules, SLA rules and auto-replies are outside Shuttio's reach. Switch off every rule that emails customers when a ticket is created, assigned or resolved (a "ticket created" mail, a satisfaction survey) before the run, because they run on imported tickets too. Or import into a department with no outgoing mailbox.
- Add the agents in LiveAgent first and Shuttio matches them by email for assignees and the authors of notes. A note whose author has no LiveAgent agent is written as the system, and its first line names the original author. Shuttio never invites anyone, and never creates a department: a ticket goes to the department of the same name, else to the account's first one.
- LiveAgent allows 180 requests a minute for one API key, so a large history is slow (about 1,300 tickets an hour with five notes each). The run waits and pauses when LiveAgent tells it to; Resume carries on.
- LiveAgent's API cannot create custom fields, so a field's values are lines of text in notes. Tags are created on the way.
Connect
- In LiveAgent, an admin opens Configuration, System, API and adds a key under API v3 (the v1 key does not work). You paste your LiveAgent address (acme.ladesk.com, or your own support domain) and the 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.
- A write cannot be tested before it is made. Shuttio checks that the key can read agents, departments, contacts, companies and tags; a refused write is named on its record.
What Shuttio writes
- A ticket with its subject, department (matched by name), tags and the status the source ended in (pending is answered, hold is postponed, solved and closed are resolved), from the customer's own contact, with the source's first message as its first message. The assignee, matched by email, is set right after. A text over 20,000 characters continues in a further note.
- Every message after the first as an internal note, in order, with the original author and time in its first line. The text is plain: HTML formatting is lost. Attachments are downloaded from the source and uploaded to LiveAgent (up to 25 MB a message); a file that cannot be copied is named in its message.
- A closing note on each ticket with what has no LiveAgent field: custom field values, original created, updated and solved times, the source's own status word, satisfaction answer and time entries.
- Every contact and company carries a source id line in its note and every ticket and note a reference, so a retry does not make a second one.
Where each thing lands
| From | Object | Lands in LiveAgent as |
|---|---|---|
| Freshdesk | Companies | Companies |
| Freshdesk | Contacts | Contacts |
| Freshdesk | Tickets | 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) |
| HubSpot Service Hub | Companies | Companies |
| HubSpot Service Hub | Contacts | Contacts |
| HubSpot Service Hub | Tickets | 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) |
| Gorgias | Customers | Contacts |
| Gorgias | Tickets | 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) |
| Freshservice | Departments | Companies |
| Freshservice | Requesters | Contacts |
| Freshservice | Tickets | 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) |
| Kustomer | Companies | Companies |
| Kustomer | Customers | Contacts |
| Kustomer | Conversations | 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) |
| Plain | Accounts | Companies |
| Plain | Customers | Contacts |
| Plain | Threads | 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) |
| Pylon | Accounts | Companies |
| Pylon | Contacts | Contacts |
| Pylon | Issues | 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) |
| LiveAgent | Companies | Companies |
| LiveAgent | Contacts | Contacts |
| LiveAgent | Tickets | 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) |
Matching, and what is never changed
- A contact whose email, or a company whose name or email, LiveAgent already has is linked to and never written or removed. A rollback does not remove it.
What the LiveAgent API cannot do
- It sets no time on a ticket, a message or a note, and no author but an agent: the original ones are the first line of each note and the closing note. The ticket's own created time is the time of the import.
- It creates no custom field, department or agent, writes no satisfaction answer, time entry or SLA state, and creates a ticket closed only as resolved.
- A contact belongs to one company: tags, address and further companies are lines in the contact's note.
Rollback
- A rollback deletes the tickets, contacts and companies the migration created, then the tags it created. A contact or company LiveAgent already had is left alone, and a ticket that is not ours is never removed.
Not answered here? Email help@shuttio.com.