Manual export from HubSpot to CSV followed by import into Bitrix24 often leads to losses: connections between contacts and deals break, communication history fragments, custom fields remain empty. Moreover, organizations face risks — lost data can cost up to 30% of revenue. We migrate data directly via HubSpot API v3 and Bitrix24 REST API, preserving the link structure and history. The team has 5+ years of experience and over 50 completed projects. Get a consultation for your project — we will assess the data volume and offer an optimal migration plan without data loss.
Why HubSpot to Bitrix24 migration is harder than it seems
HubSpot API v3 provides access to all objects: contacts, companies, deals, tickets, engagements. But the link structure differs. HubSpot uses associations with multiple links; Bitrix24 uses a flatter model with one primary company per contact. Without prioritizing multi-links, data can be lost. Additionally, HubSpot allows arbitrary properties for each object, which must be mapped to user fields. HubSpot API documentation describes over 20 field types, each requiring precise matching.
How to migrate contacts and deals
Export through HubSpot API uses cursor pagination:
$after = null; $contacts = []; do { $params = ['limit' => 100, 'properties' => 'firstname,lastname,email,phone,company']; if ($after) $params['after'] = $after; $response = $hubspot->get('/crm/v3/objects/contacts', $params); $contacts = array_merge($contacts, $response['results']); $after = $response['paging']['next']['after'] ?? null; } while ($after); Import to Bitrix24 via REST API: crm.contact.add, crm.company.add, crm.deal.add. Standard field mapping (email, phone, name). It's important that phone numbers in Bitrix24 are stored as an array, so multiple numbers must be passed via PHONE with type WORK or MOBILE.
Object mapping table
| HubSpot | Bitrix24 | Notes |
|---|---|---|
| Contact | Contact | email → EMAIL, phone → PHONE (array) |
| Company | Company | Link via COMPANY_ID |
| Deal | Deal | Pipeline → deal directions |
| Ticket | Lead or helpdesk ticket | Depends on processes |
| Owner | Bitrix24 user | Mapping by email |
| Engagement (note) | Timeline comment | crm.timeline.comment.add |
| Engagement (email) | Activity 'Email' | crm.activity.add |
| Engagement (call) | Activity 'Call' | crm.activity.add |
What about custom fields?
HubSpot allows arbitrary properties for each object. Get the schema via /crm/v3/properties/contacts. For each custom field, create a user field in Bitrix24 via crm.userfield.add. Types are mapped:
| HubSpot fieldType | Bitrix24 USER_TYPE_ID |
|---|---|
text |
string |
number |
double |
date |
date |
datetime |
datetime |
checkbox |
boolean |
select, radio |
enumeration |
textarea |
string |
What risks during migration and how to avoid them?
The main risk is losing object relationships due to differences in data models. To minimize this, we use multi-stage testing: first migrate a small sample (100–500 records), verify mapping and link correctness, then run full migration. Additionally, we set up error logging for every REST API call. If a record fails due to a duplicate or incorrect field, we log it and handle separately. Integrity is guaranteed by certified specialists with years of experience.
Scope of migration work
The migration includes full export via HubSpot API (contacts, companies, deals, activities, associations), creation of user fields in Bitrix24, mapping and transfer of communication history (emails, calls, meetings), configuration of deal pipelines and stages, multi-stage testing after transfer, delivery of mapping documentation, and team training.
Work process
- Analyze source schema: collect list of objects, custom fields, associations.
- Design mapping: determine field and type correspondences.
- Develop migration scripts in PHP using HubSpot API and Bitrix24 REST API.
- Test migration on a small sample (100–500 records) for verification.
- Full data migration, including communication history.
- Final testing: record count comparison, random checks of deals and contacts.
- Deployment and user training.
Typical timelines and guarantees
| Scale | Timeline |
|---|---|
| Up to 10,000 contacts, basic data | 2–3 weeks |
| 10,000–50,000 records with activities | 4–8 weeks |
| 50,000+ records, full history | 2–4 months |
We guarantee data integrity and minimal downtime. Migration via HubSpot API is an order of magnitude faster than manual CSV export. Contact us for a project assessment — we will design an optimal migration plan without loss. You can also order a current CRM audit: we will identify bottlenecks and provide recommendations.

