Migrate into Affinity: where data lands, setup, limits
What Shuttio writes into Affinity, where each object lands, how to connect, and what the Affinity API cannot do (create an email, add an option to a global field, delete a list or a file, set a record's creation date).
Last updated: 15 November 2026
Sources that can move into Affinity: Spreadsheet / CSV, HubSpot, Pipedrive, Affinity, Zoho CRM, Freshsales, ActiveCampaign, OnePageCRM, Cloze, Less Annoying CRM, Pipeline CRM, Zendesk Sell, Close, Copper, folk, Insightly, Bitrix24, Capsule, HighLevel, SugarCRM, SuiteCRM, Salesflare, Breakcold, Vtiger, Twenty, Attio. Affinity to Affinity moves between two different workspaces. A CSV import is free. A CRM migration is free under 20,000 records in total: contacts, companies, deals, notes, activities and files together; otherwise it is priced by record count. The sample is free. See pricing.
Object by object: What objects are supported for Affinity migrations.
Source by source: Affinity support matrix.
Connect
- Paste an Affinity API key on the Connect step (Affinity, Settings, API). Use the key of a user who may create lists and fields. Records, notes and reminders are written as that user, and only that user's key can delete them again, so roll back with the same key.
- The key is stored encrypted and deleted 14 days after the migration finishes. A migration is pinned to the Affinity workspace it first wrote to: a key of another workspace is refused.
What Shuttio writes
- Companies as organizations with name and domain. An organization is matched on its domain first, Affinity's own organization for that domain included, then on its exact name among yours; a match is linked to, never overwritten.
- People as persons with first and last name and every email, linked to their organizations. Affinity refuses an empty last name, so a name of several words is split on its last space and a one-word name gets a dash as last name. A person is matched on their exact email.
- Deals as opportunities with their persons and organizations. Each source pipeline becomes an opportunity list of the same name: yours when you have one, created otherwise. The deal's stage is an option of the list's Status field, added when missing.
- Every other source field as an Affinity field: reused when you already have one of that name, created otherwise (text, number, date, dropdown, person, organization). A person's and an organization's fields are global; a deal's are fields of its list.
- Owners as an Owner field (Owners on a list) holding the Affinity user of the same email. No user is ever created or invited.
- Notes as notes on every record they name, with their original date and the author in the first line. Tasks as reminders with their due date and done state. Meetings and calls as logged interactions with the persons they name. An email becomes a note with its sender, recipients, subject and text. Nothing is sent to anyone.
- Files are attached to the record they followed when the Attachments option is on.
- Your source's own objects (a HubSpot custom object, a Salesforce custom object, an Attio object of your own) as opportunities of an opportunity list named after the object: yours when you have one of that name, created otherwise. A record keeps its persons and organizations; its other fields become fields of that list. A record with no name is named after the object and its id.
- Your source's lists of people and of companies as person and organization lists with the same members. The list's own fields become fields of the new list, with each entry's values. A list is always a new one: a name you already use gets "(imported)".
Where each thing lands
| From | Object | Lands in Affinity as |
|---|---|---|
| HubSpot | Contacts | Persons (linked to their organizations, matched by email) |
| HubSpot | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| HubSpot | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Pipedrive | Persons | Persons (linked to their organizations, matched by email) |
| Pipedrive | Organizations | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Pipedrive | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Affinity | Persons | Persons (linked to their organizations, matched by email) |
| Affinity | Organizations | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Affinity | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Zoho CRM | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Zoho CRM | Contacts | Persons (linked to their organizations, matched by email) |
| Zoho CRM | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Freshsales | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Freshsales | Contacts | Persons (linked to their organizations, matched by email) |
| Freshsales | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| ActiveCampaign | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| ActiveCampaign | Contacts | Persons (linked to their organizations, matched by email) |
| ActiveCampaign | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| OnePageCRM | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| OnePageCRM | Contacts | Persons (linked to their organizations, matched by email) |
| OnePageCRM | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Cloze | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Cloze | Contacts | Persons (linked to their organizations, matched by email) |
| Cloze | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Less Annoying CRM | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Less Annoying CRM | Contacts | Persons (linked to their organizations, matched by email) |
| Less Annoying CRM | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Pipeline CRM | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Pipeline CRM | People | Persons (linked to their organizations, matched by email) |
| Pipeline CRM | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Zendesk Sell | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Zendesk Sell | People | Persons (linked to their organizations, matched by email) |
| Zendesk Sell | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Close | Leads | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Close | Contacts | Persons (linked to their organizations, matched by email) |
| Close | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Copper | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Copper | People | Persons (linked to their organizations, matched by email) |
| Copper | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| folk | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| folk | People | Persons (linked to their organizations, matched by email) |
| folk | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Insightly | Organisations | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Insightly | Contacts | Persons (linked to their organizations, matched by email) |
| Insightly | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Bitrix24 | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Bitrix24 | Contacts | Persons (linked to their organizations, matched by email) |
| Bitrix24 | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Capsule | Organisations | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Capsule | People | Persons (linked to their organizations, matched by email) |
| Capsule | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| HighLevel | Businesses | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| HighLevel | Contacts | Persons (linked to their organizations, matched by email) |
| HighLevel | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| SugarCRM | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| SugarCRM | Contacts | Persons (linked to their organizations, matched by email) |
| SugarCRM | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| SuiteCRM | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| SuiteCRM | Contacts | Persons (linked to their organizations, matched by email) |
| SuiteCRM | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Salesflare | Accounts | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Salesflare | Contacts | Persons (linked to their organizations, matched by email) |
| Salesflare | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Breakcold | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Breakcold | People | Persons (linked to their organizations, matched by email) |
| Breakcold | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Vtiger | Organizations | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Vtiger | Contacts | Persons (linked to their organizations, matched by email) |
| Vtiger | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Twenty | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Twenty | People | Persons (linked to their organizations, matched by email) |
| Twenty | Opportunities | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
| Attio | Companies | Organizations (matched by domain, Affinity's own one for that domain included, then by name) |
| Attio | People | Persons (linked to their organizations, matched by email) |
| Attio | Deals | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field |
What the Affinity API cannot do
- It cannot create an email: an email is a note.
- It cannot add an option to a global dropdown field, so a select field of a person or an organization is written as text. A deal's dropdowns are list fields and keep their options.
- It cannot set a record's creation date or creator: records show the date of the move. Notes keep their original date, unless it is in the future.
- An interaction must name a person: a meeting or call that names only a company or a deal is written as a note.
- It cannot delete a list, an option added to a field you already had, or a file. A cancel deletes the records, notes, reminders, interactions, list entries and fields this migration created, and names what stays: a list it made stays, empty.
- It cannot put an opportunity on a second list: an opportunity belongs to the list it was created in. A source list of deals is not copied: the deal stays in its pipeline's list and the names of the source lists it belongs to go into a multi-select field called "Source lists" on that opportunity list (yours when it has one of that name, created otherwise).
Matching, and what is never changed
- A person is matched on email and an organization on domain or name before anything is created. A record that matches one you already had is linked to, not written: its values are yours, and a cancel never removes it.
- A create that fails without an answer (a dropped connection, a 5xx) is never sent again: the row is reported as maybe written, and a Retry looks the person up by email first.
Affinity's request limits
Affinity allows 900 requests a minute per user, and the Scale and Advanced plans 100,000 a month. Shuttio writes a record's fields in one call, waits when the minute is used up, and pauses the run when the month is, naming the date it resets.
Known limits
- Products, projects and tickets are not carried in this version.
- Notes, tasks and files are not attached to the opportunities a custom object becomes.
Not answered here? Email help@shuttio.com.