Migrate from SuiteCRM: what moves, permissions, limits
What Shuttio reads from SuiteCRM, where it lands in Attio, Clarify, Odoo and 21 more, which permissions it needs and why, and what does not move.
Last updated: 20 November 2026
Your instance address and an OAuth2 client an admin creates in Admin, OAuth2 Clients and Tokens (a Client Credentials client with the user it reads as). Shuttio checks it before saving anything, stores the client ID and secret encrypted, and deletes them 14 days after the migration finishes.
Object by object: What objects are supported for SuiteCRM migrations.
How Shuttio reads SuiteCRM
- The API is SuiteCRM's V8 JSON:API. SuiteCRM 8 serves it under /legacy/Api and SuiteCRM 7 at /Api; at connect Shuttio tries /legacy/Api first and keeps the root that answers.
- Sign-in is OAuth2 with an authorization code and PKCE, through a New Authorization Client your admin creates (SuiteCRM 7.15 and later, or 8.10 and later). SuiteCRM issues a new refresh token each time one is used, and Shuttio stores the new one in place of the old.
- Shuttio reads 100 records a page, sorted by the date a record was entered. Move new records filters on that date, so a record that was only edited since the migration started is not picked up.
- The modules read are Accounts, Contacts, Leads, Opportunities, Notes, Tasks, Meetings, Calls, Emails, Project and ProjectTask. The product catalogue is AOS_Products.
- SuiteCRM's API lists no dropdown values, so Shuttio takes the opportunity stages from the stock list, Prospecting to Closed Lost, in that order. A stage your instance added still arrives with its records; it is missing only from the stage list.
- Shuttio asks for each module's field list. If the instance returns none, Shuttio takes the custom fields, the names ending in _c, from the first record it reads.
- A record carries up to two email addresses, email1 and email2, and Shuttio reads both.
- In the Emails module, the statuses sent, read, unread, replied and archived are moved; draft and send_error are not. Addresses arrive as strings that SuiteCRM stores HTML-escaped, and Shuttio unescapes them. SuiteCRM refuses an unknown name in the fields of an Emails request, so Shuttio asks only for the attributes it knows by name.
- A multi-select field arrives from SuiteCRM as one caret-wrapped string such as ^A^,^B^, and Shuttio splits it into values.
Permissions and why
| What | Why Shuttio needs it |
|---|---|
| Your instance address | Shuttio calls your own SuiteCRM, so it needs the address you open it at. It must be https and public; Shuttio refuses a private-network address and follows no redirect to another host. |
| An Authorization Client your admin creates | SuiteCRM has no app store: an admin creates a New Authorization Client in Admin, OAuth2 Clients and Tokens, with the Redirect URI https://www.shuttio.com/api/connect/suitecrm/callback. You enter its client ID and secret, then sign in to SuiteCRM and approve. Shuttio reads what your user sees; no password reaches Shuttio. |
Sign in as a user who sees everything you want to move. It needs SuiteCRM 7.15 or later, or 8.10 or later, with the API set up and its OAuth2 keys generated. SuiteCRM documents no request limit: Shuttio keeps three requests in flight and pauses the run, to resume where it stopped, if the server keeps refusing. The tokens and the client are stored encrypted and deleted 14 days after the migration finishes; Shuttio logs the token out of SuiteCRM then. Your admin can delete the client in SuiteCRM at any time.
What Shuttio reads and moves
The list below describes the move into Attio. Where Clarify or Odoo differ, the destination's own article says so.
- Accounts and contacts: Accounts become companies and contacts become people, with their emails, phones, addresses and website. A contact is linked to its account.
- Leads: Leads land as people with a lead status, as deals at the stage Lead, or as their own object, as you choose. A lead that was converted is not imported a second time: it resolves onto the contact it became.
- Opportunities and sales stages: Opportunities become deals in the stage they are in, in SuiteCRM's order. Closed Won and Closed Lost carry over as won and lost, and the deal is linked to its account and to every contact related to the opportunity (one read per opportunity).
- Products: The product catalogue (Products) becomes an object of its own, with SKU, price and description.
- Cases: Cases become an object of their own, with subject, status, priority, and the account and contact they belong to.
- Projects: Projects become an object of their own, with their status, dates and manager.
- Custom fields: Fields added in Studio (names ending _c) keep their type: dropdown and multi-select fields keep their options, number, currency, date and yes/no fields stay typed.
- Notes, tasks, meetings and calls: They land on the contact, account or opportunity they are attached to. Tasks become Attio tasks with their due date, completion and assignee; meetings become meetings; calls land in Attio's Phone calls, or as a note when the workspace has not allowed activities.
- Owners: A task's assignee is matched to an Attio member by email.
- Emails: Archived and sent emails, with subject, sender, recipients, date and body, on the account, contact or opportunity they are related to. Drafts are not read. They land in Attio as a Logged emails activity on their record, unticked by default because Attio's mailbox sync may already show the same mail.
Known limits
- The request limit: SuiteCRM documents no request limit; it is set per instance. Shuttio keeps three requests in flight, backs off when the server answers 429 or 503, and pauses the run, to resume where it stopped, when it keeps refusing.
- Quotes, contracts and invoices: Shuttio does not move SuiteCRM's quotes, contracts, invoices or campaigns. They stay there.
- Documents and attachments: Shuttio reads no documents, note attachments or email attachments from SuiteCRM. They stay there.
- Drafts and emails on leads or cases: A draft or an email queued to send never reached anyone, and an email related only to a lead or a case has no slot to land in. Neither is moved from SuiteCRM.
- Activities on leads, cases and projects: A note, task, meeting or call attached to a lead, a case or a project, with no contact named, has no slot to land in. It is counted in the run's report and not moved.
- Project tasks: Project tasks move into Odoo's Project app, not into Attio.
- Records outside your reach: SuiteCRM shows Shuttio only the records of the user who approved it. Sign in as a user who sees everything you want to move.
- Emails: sent, received and archived emails move with subject, sender, recipients, date and body, on the account, contact or opportunity they are related to. Drafts, emails that failed to send and emails related only to a lead or a case are not moved. Attachments are not read. Into Attio they land as a Logged emails activity, unticked by default because Attio's mailbox sync may already show them.
Where each thing lands
| SuiteCRM object | In Attio | In Clarify | In Odoo | In HubSpot | In Pipedrive | In Breakcold | In Twenty | In Capsule | In HighLevel | In ActiveCampaign | In Zendesk Sell | In OnePageCRM | In Cloze | In Pipeline CRM | In Less Annoying CRM | In Close | In Copper | In Keap | In Affinity | In Freshsales | In Insightly | In Zoho CRM | In SoftSync | In folk |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Accounts | Companies | Companies | Partners (companies) | Companies | Organizations | Companies | Companies | Organisations | Businesses | Accounts (matched by name, or created with a contact that works there) | Organizations (matched by name, else created) | Companies (matched by name, else a contact with only that company name) | Companies (matched by domain, then name, else created) | Companies (matched by website, then name) | Companies (matched by exact website, then exact name, else created) | Leads (matched by name) | Companies (matched by email domain, then name) | Companies (matched by email, then name) | Organizations (matched by domain, Affinity's own one for that domain included, then by name) | Accounts (matched by name) | Organisations (matched by name) | Accounts (matched by name, then website domain) | Companies table (matched by website domain, then name) | Companies |
| Contacts | People | People | Partners (contacts) | Contacts | Persons | People | People | People | Contacts (put into their business) | Contacts | Contacts (put into their organization) | Contacts (put into their company) | Contacts, as Cloze people (matched by email, linked to their company) | People (linked to their company, matched by email) | Contacts (matched by exact email, linked to their company) | Contacts (on their company's lead; a person with no company gets a lead of their own) | People (linked to their company, matched by email) | Contacts (linked to their company, matched by email) | Persons (linked to their organizations, matched by email) | Contacts (linked to their accounts, matched by email) | Contacts (linked to their organisation, matched by email) | Contacts (linked to their account, matched by email) | Contacts table (linked to their company, matched by email) | People |
| Leads | People, deals at the stage Lead, or their own object (you choose) | Its own object, created in Clarify when it has none | CRM leads | A custom object (HubSpot Enterprise), or the one you already have with that name | Leads | Not moved | A custom object, created in Twenty when it has none, or the one you already have with that name | Not moved | Not moved | Not moved | Leads | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved |
| Opportunities | Deals | Deals | CRM opportunities | Deals | Deals | Deals | Opportunities | Opportunities | Opportunities (pipeline and stage matched by name) | Deals (pipelines and stages created when missing) | Deals (pipeline and stage matched by name; the contact is required) | Deals (pipeline and stage matched by name; a contact is required) | Deals, written as projects (segment and stage matched by name) | Deals (pipelines and open stages matched by name, else created) | Pipeline items (pipeline and status matched by exact name; each hangs on a contact or company) | Opportunities (pipelines and statuses matched by name, missing ones created; each sits on a lead) | Opportunities (pipelines and stages matched by name; a missing one is named and the deal goes to the first) | Opportunities (stages matched by name; a missing one is named and the deal goes to the first; each needs a contact) | Opportunities in an opportunity list per pipeline (matched by name, else created), the stage as an option of the list's Status field | Deals (pipelines and stages matched by name; a missing one is named and the deal goes to the first; no company: one holding account) | Opportunities (pipelines and stages matched by name; a missing one is named and the deal goes to the first; won and lost are the opportunity state) | Deals (pipelines and stages matched by name; a missing one is named and the deal goes to the first; won and lost are the closing stages) | Deals table (stage, outcome and source pipeline as text columns) | Deals (an object in the group Shuttio import) |
| Products | Its own object, or the one you already have with that name | Its own object, created in Clarify when it has none | Products | Products | Products | Not moved | A custom object, created in Twenty when it has none, or the one you already have with that name | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved |
| Cases | Its own object, or the one you already have with that name | Its own object, created in Clarify when it has none | Not moved | A custom object (HubSpot Enterprise), or the one you already have with that name | Not moved | Not moved | A custom object, created in Twenty when it has none, or the one you already have with that name | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved |
| Projects | Its own object, or the one you already have with that name | Its own object, created in Clarify when it has none | Projects (Odoo Project app) | A custom object (HubSpot Enterprise), or the one you already have with that name | Not moved | Not moved | A custom object, created in Twenty when it has none, or the one you already have with that name | Projects | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved |
| Project tasks | Not moved | Not moved | Project tasks (Odoo Project app) | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved | Not moved |
Notes, tasks, meetings, calls, files, owners and lists depend on the destination. This is the row for SuiteCRM, generated from the same tables the runner uses:
Into Attio
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products, Cases, Projects | Yes | Yes | Yes | Yes | Yes | No | Yes | No |
Into Clarify
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products, Cases, Projects | Yes | Yes | As comments | As comments | As comments | No | Yes | No |
Into Odoo
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products, Projects, Project tasks | Yes | Yes | Yes | Yes | Yes | No | Yes | No |
Into HubSpot
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products, Cases, Projects | Yes | Yes | Yes | Yes | Yes | No | Yes | No |
Into Pipedrive
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products | Yes | Yes | Yes | Yes | Yes | No | Yes | No |
Into Breakcold
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | No | No |
Into Twenty
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities, Products, Cases, Projects | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into Capsule
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities, Projects | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into HighLevel
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into ActiveCampaign
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into Zendesk Sell
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Leads, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into OnePageCRM
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into Cloze
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into Pipeline CRM
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | As notes | As notes | No | Yes | No |
Into Less Annoying CRM
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | No | No |
Into Close
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | Yes | Yes | No | Yes | No |
Into Copper
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into Keap
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into Affinity
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into Freshsales
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into Insightly
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | As notes | As notes | No | Yes | No |
Into Zoho CRM
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Into SoftSync
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | As notes | As notes | As notes | No | Yes | No |
Into folk
| From | Objects | Notes | Tasks | Meetings | Calls | Emails | Files | Owners | Lists |
|---|---|---|---|---|---|---|---|---|---|
| SuiteCRM | Accounts, Contacts, Opportunities | Yes | Yes | Yes | Yes | As notes | No | Yes | No |
Each destination's own article says how its data is written: Attio, Clarify, Odoo, HubSpot, Pipedrive, Breakcold, Twenty, Capsule, HighLevel, ActiveCampaign, Zendesk Sell, OnePageCRM, Cloze, Pipeline CRM, Less Annoying CRM, Close, Copper, Keap, Affinity, Freshsales, Insightly, Zoho CRM, SoftSync, folk.
Mapping and price for each route: SuiteCRM to Attio migration, SuiteCRM to Odoo migration.
Not answered here? Email help@shuttio.com.