Done-for-you migrations are open: our consultants run yours. See the migration service

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

WhatWhy Shuttio needs it
Your instance addressShuttio 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 createsSuiteCRM 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 objectIn AttioIn ClarifyIn OdooIn HubSpotIn PipedriveIn BreakcoldIn TwentyIn CapsuleIn HighLevelIn ActiveCampaignIn Zendesk SellIn OnePageCRMIn ClozeIn Pipeline CRMIn Less Annoying CRMIn CloseIn CopperIn KeapIn AffinityIn FreshsalesIn InsightlyIn Zoho CRMIn SoftSyncIn folk
AccountsCompaniesCompaniesPartners (companies)CompaniesOrganizationsCompaniesCompaniesOrganisationsBusinessesAccounts (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
ContactsPeoplePeoplePartners (contacts)ContactsPersonsPeoplePeoplePeopleContacts (put into their business)ContactsContacts (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
LeadsPeople, deals at the stage Lead, or their own object (you choose)Its own object, created in Clarify when it has noneCRM leadsA custom object (HubSpot Enterprise), or the one you already have with that nameLeadsNot movedA custom object, created in Twenty when it has none, or the one you already have with that nameNot movedNot movedNot movedLeadsNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot moved
OpportunitiesDealsDealsCRM opportunitiesDealsDealsDealsOpportunitiesOpportunitiesOpportunities (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 fieldDeals (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)
ProductsIts own object, or the one you already have with that nameIts own object, created in Clarify when it has noneProductsProductsProductsNot movedA custom object, created in Twenty when it has none, or the one you already have with that nameNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot moved
CasesIts own object, or the one you already have with that nameIts own object, created in Clarify when it has noneNot movedA custom object (HubSpot Enterprise), or the one you already have with that nameNot movedNot movedA custom object, created in Twenty when it has none, or the one you already have with that nameNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot moved
ProjectsIts own object, or the one you already have with that nameIts own object, created in Clarify when it has noneProjects (Odoo Project app)A custom object (HubSpot Enterprise), or the one you already have with that nameNot movedNot movedA custom object, created in Twenty when it has none, or the one you already have with that nameProjectsNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot moved
Project tasksNot movedNot movedProject tasks (Odoo Project app)Not movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot movedNot 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

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, Products, Cases, ProjectsYesYesYesYesYesNoYesNo

Into Clarify

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, Products, Cases, ProjectsYesYesAs commentsAs commentsAs commentsNoYesNo

Into Odoo

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, Products, Projects, Project tasksYesYesYesYesYesNoYesNo

Into HubSpot

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, Products, Cases, ProjectsYesYesYesYesYesNoYesNo

Into Pipedrive

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, ProductsYesYesYesYesYesNoYesNo

Into Breakcold

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoNoNo

Into Twenty

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, Opportunities, Products, Cases, ProjectsYesYesAs notesAs notesAs notesNoYesNo

Into Capsule

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Opportunities, ProjectsYesYesYesYesAs notesNoYesNo

Into HighLevel

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

Into ActiveCampaign

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

Into Zendesk Sell

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, Leads, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into OnePageCRM

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into Cloze

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into Pipeline CRM

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesAs notesAs notesNoYesNo

Into Less Annoying CRM

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoNoNo

Into Close

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesYesYesNoYesNo

Into Copper

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into Keap

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into Affinity

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

Into Freshsales

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

Into Insightly

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesAs notesAs notesNoYesNo

Into Zoho CRM

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

Into SoftSync

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesAs notesAs notesAs notesNoYesNo

Into folk

FromObjectsNotesTasksMeetingsCallsEmailsFilesOwnersLists
SuiteCRMAccounts, Contacts, OpportunitiesYesYesYesYesAs notesNoYesNo

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.