Migration guide

How to Migrate from Affinity to Attio

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

Affinity stores its data in lists of people, organizations and opportunities. Plan the export per list, decide what happens to notes and relationship scores, and respect the API allotment Attio recommends for Affinity sources.

Difficulty
Medium; depends on the number of lists and list-specific fields
Typical duration
Estimate after a representative sample
Downtime
None for reading; agree how to capture changes made during the move
Native importer
Import2 via Attio on paid plans (Affinity is a supported source); CSV is the route for lists
How Affinity records land in Attio
Affinity maps to Attio What to watch
Organization Company Match on domain. Attio does not update attribute values on companies that already exist.
Person Person Match on email. Attio fills its own communication-intelligence attributes, so do not export Affinity's equivalents.
Opportunity Deal Enable the Deals object in Attio first. Opportunities live inside Affinity lists, so the stage and list fields need a destination.
List List Attio's migration tool maps to objects only, not lists. Import list membership and list fields with the CSV importer.
List field (custom column) List entry attribute Fields scoped to one Affinity list stay scoped to one Attio List. Fields used across all lists belong on the object.
Smart Field and Crunchbase field Not migrated Attio recommends excluding Smart Fields. Affinity leaves Crunchbase fields out of exports; use the equivalent Affinity Data fields.
Note Note Export from Affinity as CSV. Attio's CSV importer does not import notes, so use the migration tool or the API.

What transfers cleanly

  • Organizations, people and opportunities, with custom fields mapped to Attio attributes.
  • List membership and list-level fields, through one CSV import per list.
  • Notes, through the migration tool or the Attio API.
  • Email and meeting history, rebuilt from each user's connected mailbox and calendar.

What doesn't come across

  • API allotment. Attio advises keeping the migration to about 40% of your monthly Affinity API allotment. Large databases need splitting across months.
  • Lists in the migration tool. Records map to objects only. Every Affinity list needs a separate CSV import into an Attio List.
  • Export permissions. Exporting all lists at once is limited to Enterprise Admins on Affinity's Enterprise tier. Other roles export one saved view at a time.
  • Lists of custom objects. Affinity cannot export them yet.
  • Private notes. An Enterprise Admin export of notes includes only the notes shared with that admin.

Migration order that works

  1. Inventory Affinity lists by type (people, organizations, opportunities), with the fields and saved views each one uses.
  2. Check your role and tier: decide whether an Enterprise Admin runs the all-lists export or each list owner exports a saved view.
  3. Drop Smart Fields and Crunchbase fields from the scope; note which Affinity Data fields replace the Crunchbase ones.
  4. Remove filters from each saved view before exporting, because an export covers only the current view.
  5. Design the Attio workspace: objects, attributes, Deals object enabled, one List per Affinity list.
  6. Run the migration tool on a sample for companies, people and opportunities, staying within about 40% of the monthly API allotment.
  7. Import list membership and list fields by CSV, with Update existing selected to avoid duplicate entries.
  8. Export notes, import them, then compare counts with Affinity before connecting mailboxes and retiring the old workspace.

Start from the lists, not the objects

Affinity users work inside lists: a deal list of opportunities, an investor list of organizations, a network list of people. Each list carries its own columns. The export therefore starts with a list inventory, not a contact export.

For each list, write down its type, owner, the fields only that list uses, and the saved view that holds the full set of entries. An export covers only the current saved view, so remove filters before you run it.

Split the work between the two Attio routes

Attio's migration tool supports Affinity as a source on paid plans. It moves records to objects: Organizations to Companies, People to People, Opportunities to Deals. It cannot map to lists.

List-level data goes through the CSV importer instead. Attio's CSV limits are 100,000 rows, 100 columns and 100 MB per file. Choose Update existing on list imports so a second run does not duplicate entries.

Mind the API budget

Attio's guidance for Affinity is to migrate a record count equal to about 40% of your monthly API allotment. Read your allotment before planning the sample. If the database exceeds the budget, import in batches across billing periods, and keep Affinity live until the last batch is checked.

What to leave behind

Exclude Smart Fields: Attio's own communication attributes populate from connected mailboxes. Crunchbase fields never reach the export. Pull the matching Affinity Data fields instead, or accept the gap.

Done for you, by Craftt

Need help moving from Affinity 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

Can the Attio migration tool move my Affinity lists?
No. Attio documents that companies, people and deals map only to objects, not lists. Import list membership and list fields with the CSV importer.
Does the Affinity export include everything shown in a list?
Not always. Crunchbase fields are excluded, the Connections column exports no data, and an all-lists export contains only a fixed set of columns per list type.
Who can export all Affinity lists at once?
Enterprise Admins on the Enterprise tier. The result is a ZIP with one CSV per list. Other users export one saved view at a time as CSV.
What happens to Affinity's relationship strength?
Affinity can export a Relationship Strength CSV with scores and interaction counts for people and organization lists. Attio calculates its own communication attributes after mailboxes connect, so keep the Affinity file as a reference, not an import.