Keep each record tied to its source ID. Use the references below to choose field owners and preserve relationships between records.
Download the mapping worksheet · CSV, no email required
Record matching
Company / Accounts
Compare whether HubSpot Company and Salesforce Accounts describe the same company in your business.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Retain the source company ID and the destination customer/company ID. Separate legal entities, subsidiaries, and business units; a shared name or web domain is insufficient.
- Field ownership
- Assign ownership separately for relationship details and finance-controlled billing details.
Fields to include
- Source record ID
- Legal or display name
- Business-unit reference
- Lifecycle status
- Record dependencies
- Resolve parent organizations, business units, and currency references before dependent transactions.
- Validation
- Use two organizations with similar names and one with multiple business units. Verify that an update reaches the intended entity only.
- Recovery
- Repair the cross-system ID relationship before retrying dependent records; do not merge companies solely to remove a sync error.
References: HubSpot: Company documentationSalesforce: Accounts documentation
Record matching
Contact / Contacts
Compare whether HubSpot Contact and Salesforce Contacts describe the same contact in your business.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Use a stable person/contact ID and an explicit cross-system lookup. Email can change and can be shared, so treat it as a matching clue rather than a universal key.
- Field ownership
- Keep consent and communication preferences under an agreed authority; a general contact update must not silently resubscribe someone.
Fields to include
- Source person ID
- Display name
- Email address
- Organization reference
- Consent state
- Record dependencies
- Resolve the organization relationship and any owner or consent references required by the destination.
- Validation
- Test an email change, two records sharing an email, and a person associated with multiple organizations.
- Recovery
- Hold ambiguous matches for review and reconcile the person ID before retrying; preserve the consent decision already recorded by its owner.
References: HubSpot: Contact documentationSalesforce: Contacts documentation
Record matching
Deal / Opportunities
Compare whether HubSpot Deal and Salesforce Opportunities describe the same deal or opportunity in your business.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Keep the opportunity/deal ID separate from any later order or invoice ID.
- Field ownership
- The sales process owns qualification and stage changes; downstream financial records have their own state and approval rules.
Fields to include
- Source deal ID
- Stage
- Amount and currency
- Expected close date
- Company reference
- Record dependencies
- Map the customer and sales pipeline before the opportunity; map stage values deliberately.
- Validation
- Test a reopened won deal, a stage with no destination equivalent, and an amount using a different currency.
- Recovery
- Suspend downstream creation for a rejected deal and review whether an order already exists before retrying.
References: HubSpot: Deal documentationSalesforce: Opportunities documentation
Business process
Ticket / Tasks and Events
Support-to-work-item handoff: HubSpot Ticket provides context for Salesforce Tasks and Events. These are related records, not equivalent entities.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Retain separate ticket and task IDs with an explicit relationship; several tasks may resolve one ticket.
- Field ownership
- Choose which ticket conditions create a work item and which task outcomes may update the support case.
Fields to include
- Source record reference
- Destination record reference
- Approved handoff state
- Duplicate-detection key
- Record dependencies
- Resolve requester, organization, team, and status references before ticket updates.
- Validation
- Escalate the same ticket twice, close one of several tasks, and verify that private ticket content is not copied into a public work item.
- Recovery
- Check whether a reply or notification was already sent before replaying ticket actions.
References: HubSpot: Ticket documentationSalesforce: Tasks and Events documentation
Record matching
Ticket / Cases
Compare whether HubSpot Ticket and Salesforce Cases describe the same support case or ticket in your business.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Retain the ticket ID and distinguish parent tickets, follow-ups, and merged cases.
- Field ownership
- Agree which queue controls status and assignee; keep private comments distinct from public replies.
Fields to include
- Source ticket ID
- Requester reference
- Status
- Priority
- Assigned team
- Record dependencies
- Resolve requester, organization, team, and status references before ticket updates.
- Validation
- Test a merged ticket, a private note, a reopened case, and an attachment with restricted access.
- Recovery
- Check whether a reply or notification was already sent before replaying ticket actions.
References: HubSpot: Ticket documentationSalesforce: Cases documentation
Record matching
Product / Products and Price Books
Compare whether HubSpot Product and Salesforce Products and Price Books describe the same product or catalog item in your business.
Object-specific availability and field permissions determine this mapping. Use the restrictions shown for each record type.
- HubSpot
- Documented record · ✅ Supported
- Salesforce
- Object support to establish
- Record identity
- Distinguish the product ID, variant ID, SKU, and price-list entry; they are not interchangeable keys.
- Field ownership
- Assign ownership for catalog content, price, and stock separately.
Fields to include
- Source product ID
- SKU or variant reference
- Description
- Unit of measure
- Price-list reference
- Record dependencies
- Resolve units, variants, categories, and applicable price lists before order lines.
- Validation
- Test two variants of one product, a changed SKU, and a price that applies to only one market or currency.
- Recovery
- Repair the variant or price-list reference before retrying affected order lines; preserve existing transaction prices.
References: HubSpot: Product documentationSalesforce: Products and Price Books documentation