HubSpot · Moving in

Move from HubSpot to a Parody

Export your records from HubSpot, import them into a HubSpot Parody with CSV files, check them, then switch over. You can move back the same way: Move back to HubSpot.

Before you start#

HubSpot exports one object at a time from its index pages, as CSV, XLS, or XLSX, and emails you a download link. You'll export companies, contacts, deals, and tickets, write a short pipelines sheet, and turn the association columns into one links file.

Who can do this

You need the Export permission; a super admin can grant it. HubSpot allows 300 exports in 24 hours and 3 at once, and the download links last 30 days.

What comes over

In HubSpotIn your Parody
CompaniesCompanies
ContactsContacts
Deal and ticket pipelinesPipelines
DealsDeals
TicketsTickets
Associations between recordsAssociations

What doesn't

  • Email, call, and meeting history. HubSpot's record exports don't include engagement timelines.
  • Marketing emails, sequences, workflows, forms, and lists. Recreate them in the Parody.
  • Attachments, quotes as documents, and reports.
  • Custom properties without a Parody field.
  • Anything the HubSpot Parody has no field for. Check the column tables below; columns without a match are left out.

1. Set up your Parody#

  1. Create a HubSpot Parody with at least these features, so every record type has a home: Companies, Contacts, Pipelines, Deals, Tickets, Associations. See what's in the HubSpot Parody.
  2. New Parodies come with sample records. Open Import & export in your Parody, and under Start empty, delete them.

2. Export from HubSpot#

  1. Open the object's index page, such as Contacts, with the All view selected.
  2. Select Export. Choose CSV, and include all properties and associations on records.
  3. Download the file from the email HubSpot sends.

Associations

By default an export includes up to 1,000 associated records per record. Choosing all associated records works for CSV files only.

What to export:

  • Companies: the Companies index, exported with all properties and associations.
  • Contacts: the Contacts index, exported the same way.
  • Deal and ticket pipelines: pipelines aren't exported. Make a Pipelines sheet by hand from HubSpot's pipeline settings: one row per pipeline, its object type (Deal or Ticket), and its stages in order separated by semicolons.
  • Deals: the Deals index or board.
  • Tickets: the Tickets index.
  • Associations between records: they come with each export when you include associations: extra columns listing the IDs of associated records. Turn them into an Associations sheet with one row per link.

3. Prepare the files#

You need one CSV per record type. Open each export in a spreadsheet app, make the changes below, and save it as CSV (UTF-8). Keep the header row.

Exports use property labels as column names, so custom labels in your account may differ from the tables below. Pick the matching field in the import screen.

Keep the ID column

Map HubSpot's own ID to ID. Your Parody remembers it, so later files can link to the record by that ID, and importing a fresh export later updates records instead of duplicating them.

Companies

HubSpot columnParody field
Record IDID (match and link rows)
Company nameName
Company Domain NameDomain
IndustryIndustry
Number of EmployeesSize
CityCity
Company ownerOwner

Contacts

HubSpot columnParody field
Record IDID (match and link rows)
First NameFirst name
Last NameLast name
EmailEmail
Phone NumberPhone
Job TitleJob title
Lifecycle StageLifecycle stage
Contact ownerOwner

Pipelines

HubSpot columnParody field
PipelineName
Object typeObject type
StagesStages

Deals

HubSpot columnParody field
Record IDID (match and link rows)
Deal NameName
AmountAmount
PipelinePipeline
Deal StageStage
Close DateClose date
Deal probabilityProbability
Deal ownerOwner

Tickets

HubSpot columnParody field
Record IDID (match and link rows)
Ticket nameSubject
Ticket descriptionDescription
PriorityPriority
PipelinePipeline
Ticket statusStage
Ticket ownerOwner

Associations

HubSpot columnParody field
from_typeFrom type
from_idFrom
to_typeTo type
to_idTo
labelLabel

Use these column names. from_type and to_type are Contact, Company, Deal, or Ticket, and from_id and to_id are HubSpot Record IDs. Because you mapped Record ID to ID when importing those records, the IDs link straight to them.

4. Import, in this order#

Import parents before the records that link to them, so links resolve:

  1. Companies
  2. Contacts
  3. Pipelines
  4. Deals
  5. Tickets
  6. Associations

For each file:

  1. In your Parody, open Import & export.
  2. Under Import, choose the record type and the CSV file.
  3. Check the column list. Columns named like the tables above are matched for you; pick a field for any that aren't, or leave them out.
  4. Select Import. If any row has a problem, nothing is written and you get a list of the problems by line number. Fix the file and import again, or tick Skip rows with problems.

Files can hold up to 5,000 rows and 4 MB. Split bigger exports and import the parts one after another. The full rules are in Import & export.

5. Check the result#

  • Compare the counts on your Parody's overview with the row counts of your files.
  • Open a few records of each type and check their links (the project on a task, the account on a contact).
  • Open the boards and reports and check that records sit in the right columns.

6. Switch over#

  1. Pick a cutover time and ask your team to stop editing in HubSpot.
  2. Export again and import the new files. Rows with an ID you've imported before update those records; new rows are added.
  3. Share the Parody's address with your team, and keep HubSpot read-only until you're sure nothing is missing.

Troubleshooting#

MessageWhat to do
No … named or with id "…"The record it links to isn't in the Parody yet. Import that record type first, or check the name is spelled exactly the same.
"…" matches 2 … recordsSeveral records share that name. Also map the column that links to their parent (the project or board), or use the ID instead of the name.
… is not a date we can readUse YYYY-MM-DD. Day-first dates like 21/11/2026 aren't read, because 03/04/2026 would be ambiguous.
… is not a numberRemove words and units other than currency symbols, commas, and %.
The file has more than … rowsSplit it into files of up to 5,000 rows.

Sources

Checked against these pages on 2026-11-21. Vendors change their export and import tools often; if a step doesn't match what you see, their page wins.