How to import old emails into Zendesk as tickets
By Jake Marsh · Updated
To import old emails into Zendesk, export the mailbox or label as an .mbox file (or a folder of .eml files), open Ferrywell from Zendesk's left navigation bar as an admin and pick the file. Ferrywell turns each thread into a ticket, makes the first sender the requester, cuts quoted history from replies and keeps every message's original date. Click Preview import, then Import.
Which email files work
| File | Works | Notes |
|---|---|---|
.mbox | Yes | The usual export from Gmail and many mail apps |
.eml | Yes | One message per file. Pick a folder or a zip of them |
Outlook .pst or .msg | No | Save the mail as .mbox or .eml from a mail tool first |
Up to 1 GB per import. Split larger archives into several imports.
Steps
- Export the mail. Export the shared inbox, label or folder that holds customer conversations.
- Create your agents in Zendesk first. Ferrywell matches people who wrote replies to Zendesk agents by email address. Anyone not found is created as an end user.
- Open Ferrywell and pick the archive. Use Pick files, Pick a folder, or drop the file on the page. Ferrywell reads the threads and lists them as a table.
- Check the matches. Email threads come in with their messages inside each ticket, so the comments are already grouped. Check the requester, subject and dates, and set Times without a zone are in if your mail tool wrote local times.
- Set the ticket options. Pick the status old conversations should get (most teams use Solved or Closed), add Tags for every ticket such as
old_inbox, and choose whether comments that don't say are internal notes. - Click Preview import. Open a few subjects to read the conversation exactly as it will be imported. Untick threads that aren't customer conversations, such as newsletters.
- Name the import and click Import. Keep the tab open. Stop after this batch stops cleanly, and History can resume it later.
How a thread becomes a ticket
| In the email archive | In Zendesk |
|---|---|
| A thread | One ticket |
| The first sender | The requester |
| Each message | A comment from its sender, at its original time |
| Quoted text in a reply | Cut, so each comment holds only what was new |
| Attached files | Named at the end of their message |
| The subject | The ticket subject |
Every ticket gets the tag ferrywell_<import id>, which you can use in views and in Explore to report on the old mail separately.
About attachments
Zendesk apps can't send files to Zendesk: the app framework turns a file into the text "[object Object]". So Ferrywell names each file in its comment, as "[Attachments not imported: ...]", instead of attaching a damaged copy. Keep the original archive if you may need the files.
Nothing is emailed
Zendesk runs no triggers and sends no notifications for imported tickets, and new end users are created verified. Your old customers get no email when their conversations land in Zendesk. Zendesk also doesn't carry ticket metrics such as first reply time and first resolution time onto imported tickets, as its migration article notes.
What it costs
Ferrywell is a one-time payment per Zendesk account: Standard $299 once for up to 5,000 tickets, Plus $599 once for up to 25,000, Unlimited $999 once with no limit. There is no trial. Each email thread counts as one ticket. Details are in the Ferrywell documentation.
Ferrywell
Historical ticket importer: past tickets keep their comments, authors and dates. Preview, then undo. From $299 once per Zendesk account.
Questions
Can I import a Gmail label into Zendesk?
Yes. Export the label as an .mbox file and pick it in Ferrywell. Each thread becomes a ticket with the customer as requester and the original dates.
Will the tickets show today's date?
No. Each ticket and each message keeps the date from the email, so 2020 conversations sit in 2020.
Our replies came from a shared address. Who gets credited?
Messages are credited to their sender's email. If that address is a Zendesk agent, the agent is the author; otherwise it becomes an end user. Create an agent for the shared address before importing if you want replies credited to your team.
Are the old emails searchable in Zendesk?
They become normal tickets and comments, so Zendesk search finds them like any other ticket.