Browse the docs
Import from Asana, monday.com, ClickUp and more
Updated
On this page
Bring your projects from Asana, monday.com, ClickUp, Jira, Linear, Trello, Notion or Todoist into OneCamp: projects with their tasks, subtasks, statuses, assignees, dates, custom fields, comments and files. A workspace admin runs it from Admin → Import, and nothing is written until you've seen the plan.
What comes across
| From | Becomes |
|---|---|
| Workspaces, teams, spaces | Teams |
| Projects, boards, lists, databases | Projects |
| Tasks, items, issues, cards | Tasks, with their status, priority, assignee, start and due dates and labels |
| Subtasks, subitems, sub-issues | Subtasks |
| Comments and updates | Comments, in the order they were written |
| Attached files | Attachments on the task or comment |
| Custom fields and extra columns | The project's own custom fields, with each task's values |
People are matched to OneCamp accounts by email. Anyone not found is added, so every task keeps its owner and every comment its author; invite them later and they pick up where they left off.
How to run it
- Open Admin → Import and pick where you're coming from.
- Connect: paste a token from the other tool (where to find it is below). Tokens are encrypted on your server and never shown again.
- Start an import, choosing what to bring: a workspace, a board or a project, depending on the tool. Only what you pick comes across; a Jira project brings its own people and category, not the whole site's.
- Plan: OneCamp counts what it found (people, projects, tasks, comments, files) and lists every status it saw. Pick the OneCamp status each one becomes; common ones are filled in for you.
- Run. Progress shows as it goes, live. If something can't come across, the import carries on and lists it under Errors. Pressing Run twice starts it once.
- Changed your mind? Roll back takes out everything that import made.
When it finishes, invite who came across
The admin who ran the import is told when it finishes or fails, wherever they are in OneCamp, and offered Invite the N people who came across. The list says why anyone isn't offered (already a member, already invited, gone from the other tool, or no real email address), how many seats your plan has left and how many invitation emails can go today. Anyone past today's email limit is still invited: copy their link from Admin → Invitations. When they join, their imported tasks and comments are already theirs. A placeholder person's profile also offers Invite to the workspace.
If something goes wrong
- A token the tool refused (or one this server can no longer read) shows Reconnect.
- A failed import can be planned again or run again.
- An import waiting to be planned can be discarded; one left waiting for a
day is set aside (
IMPORT_PENDING_TTL_HOURSchanges how long). - A pause the tool imposes, such as monday.com's daily limit, says when it lifts, and the import carries on then.
- Errors never keep the tool's key or token.
Where to find the token
| Tool | What to paste |
|---|---|
| Asana | A personal access token from its developer console (app.asana.com/0/my-apps) |
| monday.com | Your avatar → Developers → My access tokens → Show |
| ClickUp | Settings → Apps → API token |
| Jira | Your email, a classic API token (id.atlassian.com → Security → Create API token, not a scoped one) and your site's address |
| Linear | Settings → API → a personal API key |
| Trello | The API key of a Power-Up you create at trello.com/power-ups/admin, and a token generated from that key |
| Notion | An internal integration token; share the task databases with the integration first |
| Todoist | Settings → Integrations → Developer → API token |
The import sees what that token's person can see. Use an account that can open everything you want to bring.
Notes by tool
- monday.com: the Status column (or the item's group) becomes the status, the people column the assignee, a timeline or date columns the dates, and tags the labels. Other columns become custom fields: another status column, dropdowns, numbers (money when the unit is a currency), people, dates, checkboxes, links, ratings and text. Columns with no field of their kind (formulas, mirrors, connections) are kept as a list in the task's description. Documents aren't boards and are left out.
- Asana: each project's custom fields come across with their values. A field called Priority becomes the priority instead, and a formula's value goes into the task's description.
- ClickUp: custom fields come across (dropdowns, labels, numbers, money, dates, checkboxes, links, people, ratings and text), and subtasks under their parents.
- Jira: a custom field comes across when an issue in the project has a value for it: selects, checkboxes, labels, numbers and story points, text, links, dates and people. Sprints, epics and ranks don't. Jira retired the search that older releases of OneCamp used: update before importing from Jira.
- Linear: sub-issues come across under their parents.
- Notion: each task database becomes a project and each row a task. Its other properties become custom fields; a multi-select called Tags or Labels becomes the task's tags. Pages are copied over by hand for now.
- Trello: fields from the Custom Fields power-up come across: dropdowns, checkboxes, dates, numbers and text.
- Todoist: Todoist retired the API that older releases of OneCamp used: update before importing from Todoist.
A project can have up to 30 custom fields, and a field up to 50 options. A value no field can keep (one past those limits, a person who wasn't imported, a link that isn't one) is written into the task's description under Imported fields, as the other tool showed it, and Errors says why, once for each field. The import carries on either way.
- Slack history has its own import, from an export file (up to the size your server allows, shown in the dialog). Slack's #general goes into your #general while that holds only its welcome post, and never into one shared with guests. Channels archived in Slack are archived here, and the admin who ran it leaves private channels they weren't in. See the Slack bridge for running both side by side while people move.
Imports are in every edition of OneCamp, the free one included.
Something missing or wrong in this guide? Write to support@onemana.dev.