Bring your history over from Help Scout, Zendesk or Freshdesk so agents find earlier conversations next to new ones. You upload an export file you downloaded yourself. Formspring does not connect to your old helpdesk account. Open Desk settings → Import; only workspace owners and admins can import.
1. Export from your old helpdesk
| Helpdesk | File | Notes |
|---|---|---|
| Help Scout | JSON | Conversations with their threads. |
| Zendesk | JSON or CSV | A JSON export carries every comment, public and private. A CSV export has one row per ticket, so only the first message is imported and Desk tells you history is missing. |
| Freshdesk | JSON or CSV | Same as Zendesk. |
Unzip archives first; ZIP files are not accepted. Files can be up to 10 MB. For a bigger history, export a date range at a time. Importing the same period twice is safe.
2. Check the file first
Choose the helpdesk, the project the conversations land in, and the file, then click Check the file. Nothing is written yet. You see:
- how many conversations, messages, private notes, attachments and tags the file holds
- what an import would do: new conversations, conversations that get new messages, and what is already imported
- What will not carry over, each item with a count and example ids
- Who handled these conversations
Statuses map like this: active, open, new and Freshdesk "Open" become open; pending, on hold and "Waiting on customer" become pending; solved, closed and resolved become resolved; spam stays spam. A status Desk does not know becomes open and is listed so you can see how many.
3. Map your agents
People in the export are matched to your team by email address, but only teammates who can open the project are used. Anyone else keeps their name and email on the conversation without getting a login.
If the person who left has a stand-in on your team, choose a teammate under Map to next to their name. Their conversations are assigned to that teammate and their replies and notes show that teammate as the author. You can only pick workspace members who can open the project.
4. Import
Click Import. The import runs in the background and you can leave the page; it reports progress and a summary when it finishes.
What you can rely on:
- Original dates and order. Each conversation and message keeps the time it had in the old helpdesk.
- Nobody is contacted. Imported history never sends an email, never notifies an agent and never starts a reply clock. An agent can reply to an imported conversation normally afterwards.
- Private notes stay private. Private comments become internal notes that only your team sees.
- Safe HTML. Message bodies are cleaned before they are stored.
- Safe to repeat. Importing the same export again adds nothing twice. If the export grew, only the new messages are added, and changes agents made after the first import are kept.
- Attachments are references. File names and sizes are kept, the files themselves are not downloaded.
From the API and agents
The same flow is available as POST /api/v1/desk/imports/dry-run, POST /api/v1/desk/imports and GET /api/v1/desk/imports/{run}, and as the MCP tools import_desk_export and get_desk_import_run. Send the person key from the dry run as assignee_map, for example {"alex@old-company.example": 12}. See the API reference.
Next
- Inbox and threads → - find imported conversations
- Email channels → - receive new mail in Desk
