Skip to main content
Use Hightouch to create and update contacts in Conversion. Set up an HTTP Request destination, map your contact fields, and choose how often to sync.
For help syncing audience memberships from Hightouch, contact our team for setup details.

​
Before you begin

Make sure you have:
  • A Conversion API key. Generate one from Settings → API Keys. See API.
  • A Hightouch model with one row per contact, a unique primary key, and an email column.
  • Permission to create destinations and syncs in Hightouch.
  • Contact fields in Conversion for any attributes you want to send. Use List Fields to find their writable field keys.

​
Connect Hightouch to Conversion

1

Create the destination

In Hightouch, go to Destinations → Add destination, select HTTP Request, and name it Conversion.Save the destination. You can reuse it for contact and event syncs to the same Conversion workspace.
2

Create a contact sync

Create a sync using your contact model and the Conversion destination.Enable Rows added and Rows changed. Configure both triggers with these settings:Leave Rows removed disabled to keep contacts in Conversion when they leave the source model.
3

Map contact fields

Map your email column to email. Optionally map an object column containing contact attributes to fields. The keys inside fields must match Conversion field keys.For example, your mappings could produce:
Hightouch generates one request per contact using your mappings. Conversion creates contacts with new emails and updates matching contacts with the fields you send.
If your attributes are separate columns, use Create an object to group them under fields. This inline mapping feature requires Hightouch enablement. If it is unavailable, ask your data team to provide an object column.
4

Choose a schedule

Configure the initial run to send existing rows if you want to import your current contacts. Choose a sync schedule and enable retries for failed rows.On subsequent runs, Hightouch sends new contacts and changes to existing contacts.

​
Test the connection

Run the sync with a small set of contacts. Check for rejected rows in Hightouch and confirm the contacts and fields in Conversion. Change one field in your source and run again to check that the contact is updated.

​
How contacts are updated

Conversion matches contacts by email. Fields you send overwrite existing values by default; omitted fields are left unchanged. To fill only empty fields, set preserveExistingFields to true. To change an existing contact’s email, identify it with its cnvContactId. See Upsert Contact for the full request options.