How to Migrate from Capsule to Attio
Capsule exports Contacts, Opportunities and Projects as three CSVs with notes and email history in a column. Plan the export link's 12-hour window, the missing attachments and where Projects land in Attio.
- Difficulty
- Easy to medium
- Typical duration
- Estimate after a representative sample
- Downtime
- None for reading; agree a cutover date for new records
- Native importer
- Import2 via Attio on paid plans (Capsule is a supported source); CSV and API are alternative routes
| Capsule CRM | maps to | Attio | What to watch |
|---|---|---|---|
| Organisation (Contacts) | Company | Capsule keeps people and organisations in one Contacts list. Split them by type before import; match companies on domain. | |
| Person (Contacts) | Person | Attio matches people on email. Check people with several emails or none. | |
| Opportunity | Deal | Enable the Deals object first. Check milestone, value, expected close date and owner. | |
| Project | Custom object or List | A Project has a stage on a board, a primary contact, an expected close date and linked contacts and opportunities. Use a List with a status attribute or a custom object. | |
| Task and Track | Task (rebuild) | The account export lists three CSVs and no tasks file. Tracks are task templates an admin creates; Attio has to recreate them as automations or process. | |
| Note and email history | Note | Held in the last column of each exported CSV. Attio's CSV importer does not import notes; use the migration tool or the API. | |
| Tag | Select or multi-select attribute | Normalise spelling first. |
What transfers cleanly
- Organisations, people and opportunities, with custom fields.
- Projects, as a List or a custom object.
- Notes and email history, through the migration tool or the API after reading the last CSV column.
- Live email and calendar history, rebuilt from each user's connected mailbox.
What doesn't come across
- Attachments. The full export contains no file attachments; download each one from its record.
- Twelve-hour link. The emailed export link expires after 12 hours, so plan to download the ZIP the moment it arrives.
- Who can export. The Super Administrator, or an administrator with Export Rights, runs the account export.
- Tasks and Tracks. No tasks file appears in the export. Check open tasks in a sample and recreate Tracks by hand.
- One Contacts file. People and organisations share a file and need splitting.
Migration order that works
- Check who holds Export Rights; give them to the person running the migration.
- In Account Settings choose Export Data; download the ZIP from the email within 12 hours.
- Open the three CSVs; note counts of contacts, opportunities and projects, and open tasks per user.
- Download attachments you need from their records, since the export omits them.
- Split the Contacts file into organisations and people; add company domains to people.
- Prepare Attio: enable Deals, create a List or custom object for Projects, add custom attributes.
- Run the migration tool on a sample, or import by CSV in order: companies, people, deals, then Projects.
- Load notes and email history from the exported column; compare counts with Capsule before cutover.
Run the export while you can download it
Capsule's full export is an account task. The Super Administrator, or an administrator with Export Rights, opens Account Settings and chooses Export Data. Capsule emails one link; the link expires after 12 hours. Check who receives that email before you start.
The ZIP holds Contacts, Opportunities and Projects as CSV, UTF-8 encoded. Open the files in a tool that reads UTF-8, or special characters in names will break before they reach Attio.
Split Contacts and decide on Projects
Capsule puts people and organisations in one Contacts file. Attio wants Companies and People as separate imports, with the company domain on each person row so records link without duplicates.
Projects have no direct Attio object. Capsule describes them as records for work such as a campaign or client job, arranged by stage on a board, linked to several contacts and opportunities. If you report on them by stage, import them as an Attio List with a status attribute. If they carry fields of their own, create a custom object.
History and files
Notes and email history are the last column of each CSV. That column is not an Attio import format: Attio's CSV importer takes no notes, so load them through the migration tool or the API, parent record first. Attachments need a manual download from each Capsule record, and the export does not contain them.
Need help moving from Capsule CRM to Attio?
Craftt, the CRM team behind weekcrm, plans and runs the migration: field mapping, deduplication, history and a cutover your team won't notice. You get a fixed quote within one business day.

