Skip to main content
Conversion maintains a link between your Salesforce records and Conversion records using the Salesforce ID as the primary connection. This is what enables the two-way sync to work reliably.

Matching Records

When records sync between Salesforce and Conversion, the systems match records using:
  1. Salesforce ID - The primary way Conversion identifies which contact a Salesforce record belongs to. If a Conversion contact is already linked to a Salesforce ID, that contact is always updated.
  2. Email address - When no Salesforce ID link exists, Conversion looks for existing contacts with the same email address and links to the most recently updated match (if it doesn’t already have a different Salesforce ID).
This matching ensures that:
  • Updates go to the right records in both systems
  • Duplicates are minimized by linking identifiers when possible
  • New contacts are only created when a true conflict exists (the matching contact already belongs to a different Salesforce record)

Data Flow Overview

Understanding how data moves between Salesforce and Conversion helps you predict sync behavior and troubleshoot issues when they arise.

Sync Direction and Timing

Conversion syncs with Salesforce in both directions, but the two directions work differently:
How it works: Conversion periodically checks Salesforce for new and updated records, then pulls those changes into your Conversion database.What triggers a sync:
  • Scheduled sync intervals
    • Runs every 5 minutes, and after the previous sync is finished
  • Records are synced based on their last modified date in Salesforce
What gets synced:
  • New Leads, Contacts, and Accounts created since the last sync
  • Existing records that have been modified since the last sync
    • If a record’s updated_at timestamp is more recent that the Conversion field’s updated_at timestamp, the field will attempt to sync. Then configured field sync preferences apply.
Records that don’t sync:
  • Leads and Contacts without an email address
  • Leads that have already been converted to Contacts (the Contact record syncs instead)

Frequently Asked Questions

Yes. When contacts are added to Conversion (through form submissions, CSV uploads, etc.), you can choose to sync them to Salesforce immediately or skip the initial sync. If you skip it, you can always sync them later through workflows or the dashboard.
Yes, Conversion allows duplicate email addresses when necessary. For example, when a Salesforce record syncs and the matching email is already linked to a different Salesforce ID.
No. Each contact belongs to exactly one company at any time. If their company association changes (for example, if a Salesforce Contact moves to a different Account), their company in Conversion updates accordingly.
Conversion handles this automatically. The contact remains in Conversion and re-links to the new Salesforce Contact record. If the Contact is associated with an Account, the contact will also move to the appropriate company in Conversion.
Conversion contacts have a linked company if the contact is synced to a Salesforce Contact linked to a Salesforce Account.Conversion contacts that don’t have a linked company still have company fields to store company-level information.
Conversion uses a strong identifier first (like a Salesforce ID, browser cookie, or userId) to find the right contact. If no strong identifier match exists, it falls back to email address and selects the most recently updated contact. A new contact is only created when there’s a true identifier conflict.
You’ll see a warning in the dashboard, but you can still proceed. The new contact will be created as a separate record. You can merge duplicates later if needed.