Migrate from HubSpot to Twenty CRM

HubSpot Contact records map directly to Twenty Person records. The HubSpot firstname, lastname, email, phone, and address properties map to Twenty's corresponding Person fields. Custom contact properties migrate as custom fields on the Person object. HubSpot's lifecyclestage property maps to a custom picklist field on Person (Twenty does not have a native Lifecycle Stage equivalent). The HubSpot Marketing Contact billing flag value is preserved in a custom field for audit purposes.

HubSpot Company records map 1:1 to Twenty Company records. The HubSpot company domain becomes the Company website field and is used as the dedupe key during import. All standard and custom company properties migrate as fields on the Twenty Company object. The HubSpot contact-to-company association (the primary company link) migrates to Twenty's Person-Company workspace relationship.

HubSpot Deals map to Twenty Opportunities. The HubSpot dealname becomes Opportunity name; dealstage maps to Twenty pipeline stage; amount maps to Opportunity amount; closedate maps to Opportunity close date. HubSpot pipeline configurations migrate as Twenty pipeline definitions with stage names and probabilities preserved. The HubSpot closedate becomes the Opportunity expectedCloseDate in Twenty.

Each HubSpot pipeline stage maps to a Twenty pipeline stage definition. Stage display names and probability percentages migrate as stage metadata in Twenty's pipeline configuration. HubSpot's pipeline-level display order is preserved in Twenty's stage ordering. Customers with multiple HubSpot pipelines create corresponding Twenty pipelines during schema setup.

HubSpot deal pipelines (up to 15 on Professional, 100 on Enterprise) map to Twenty pipeline definitions. Each HubSpot pipeline becomes a separate Twenty pipeline with its own stage set. The mapping preserves pipeline-level properties including default currency and display color. Pipeline access permissions in Twenty are set during user provisioning.

HubSpot Products map to Twenty Product records. The HubSpot hs_sku maps to Product sku; name maps to Product name; price maps to Product priceAmount. Products are created before any line item or opportunity association so that the foreign key reference is satisfied at insert time.

HubSpot Line Items map to Twenty OpportunityLineItem records linked to the corresponding Opportunity. We resolve the Product reference, quantity, and unit price at migration time. The line item's hs_discount_percentage migrates as a custom discount field on the line item record.

HubSpot Owners map to Twenty User records. We resolve owners by email match against the Twenty user table. Any HubSpot Owner without a matching Twenty User goes to a reconciliation queue for the customer's admin to provision before record import resumes. Owner assignment on Deals and Contacts is resolved via the User mapping after User records are confirmed.

HubSpot email engagements migrate to Twenty Task records with type set to Email. The email subject, body, from address, and to address transfer to custom fields on the Task. The Task is linked to the target Person and optionally to the related Opportunity via Twenty's workspace relationship. Activity timestamp is preserved from the original HubSpot engagement creation date.

HubSpot call engagements map to Twenty Task records with type set to Call. Call disposition, duration in seconds, and recording URL transfer to custom fields on the Task. Activity timestamp preserves the original HubSpot call start time. The Task is linked to the target Person via the workspace relationship.

HubSpot meeting engagements map to Twenty Task records with type set to Meeting. Title, description, start time, end time, and location migrate to corresponding fields on the Task. Attendees are linked via the workspace PersonTaskInteraction records. Activity timestamp preserves the original HubSpot meeting start time.

HubSpot Notes migrate as Comment records in Twenty, linked to the target Person or Opportunity via the workspace relationship. Note body text migrates as the Comment text field. If the HubSpot Note is attached to a Deal, the Comment links to the corresponding Twenty Opportunity.