Migration guide

How to Migrate from Capsule to Attio

By WeekCRM editorial team · · Sources reviewed 2026-11-20 · Editorial policy & disclosures

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
How Capsule CRM records land in Attio
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

  1. Check who holds Export Rights; give them to the person running the migration.
  2. In Account Settings choose Export Data; download the ZIP from the email within 12 hours.
  3. Open the three CSVs; note counts of contacts, opportunities and projects, and open tasks per user.
  4. Download attachments you need from their records, since the export omits them.
  5. Split the Contacts file into organisations and people; add company domains to people.
  6. Prepare Attio: enable Deals, create a List or custom object for Projects, add custom attributes.
  7. Run the migration tool on a sample, or import by CSV in order: companies, people, deals, then Projects.
  8. 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.

Done for you, by Craftt

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.

Frequently asked questions

What does a Capsule account export include?
A ZIP with three CSV files: Contacts, Opportunities and Projects. Note and email history is in the last column of each. File attachments are not included.
Who can run the full Capsule export?
The Super Administrator, or an administrator who has been given Export Rights. It is available on all plans, under Account Settings, Export Data.
How long is the download link valid?
12 hours after Capsule emails it.
Is Capsule a supported source for Attio's migration tool?
Yes, on paid plans. Existing records are matched on email for people and domain for companies; their attribute values are not updated.