Skip to main content
Available on the Pro, Teams, and Enterprise plans.
The Salesforce integration syncs Wave Connect contacts into Salesforce as either Leads or Contacts, your choice at setup. Wave Connect uses a custom external ID field to upsert records, preventing duplicates even if a record already exists. Both production and sandbox Salesforce environments are supported.

How to connect

1

Open the integration

Go to Integrations, open Salesforce, and click Install App.
2

Choose where to install it (organizations)

In an organization, choose whether to connect Salesforce for the whole organization or for a single team. See Organization and team integrations.
3

Choose a record type

Under Resource, choose whether to sync contacts as Leads or Contacts. To connect a sandbox, turn on Connect to a Salesforce Sandbox.
4

Keep contact sync on

Leave Automatically send new Wave contacts to Salesforce on to import your existing Wave Connect contacts right away and sync new ones in real time.
5

Connect Salesforce

Click Continue and sign in to your Salesforce account.
Wave Connect requests offline access (to keep the connection active without repeated logins) and read/write access to create and update records in Salesforce. Once connected, open the integration’s Settings to see where it’s connected, turn Contact sync and Event sync on or off, and edit the Attributes mapping.

Attributes mapping

By default, contact fields sync to the Salesforce fields listed under What Gets Synced below. You can send any Wave Connect field to a different Salesforce field, including custom ones, and sync additional fields such as work email, tags, events, and your organization’s custom attributes and qualifiers.
1

Open the integration settings

Go to Integrations → Installed Integrations and open the Salesforce integration’s Settings.
2

Find attributes mapping

Each row pairs a Wave Connect Contact Field with a Salesforce Field. Pick a Salesforce field from the second column, or click the X to stop syncing that field.
3

Add a field (optional)

Click Add field and pick a contact field, a Wave field (Tags, Events), one of your Custom fields, or a Static value.
4

Map the options (optional)

When a field with options (a select attribute, tags, or events) is mapped to a Salesforce picklist, click the options button on that row to open Map options and choose which Salesforce value each option syncs to. Options with the same name are matched automatically.
5

Save

Click Save. The new mapping applies to the next sync.
The Salesforce fields in the list are read live from your connected account, so any custom field you created appears alongside the standard ones. If you add a field in Salesforce while the page is open, click the refresh icon in the column header to reload the list.
  • Static value: send the same value for every contact, for example a lead source. Turn on On create to send it only when the Salesforce record is first created.
  • Create field from Salesforce property: admins can pick a Salesforce picklist and create a matching Wave Connect select field, with the same options, already mapped to it.
  • Wave Connect converts values to the Salesforce field’s type. A value that doesn’t fit the field, such as text in a number field or an unmapped option in a restricted picklist, is skipped.

What gets synced

The table below is the default field mapping. You can change it from the Attributes Mapping section above. For address fields, the first name applies when syncing as Leads and the Mailing* variant when syncing as Contacts. When syncing as Contacts, the company is saved as a linked Account. Sync direction: Wave Connect → Salesforce (outbound only) When it syncs: Real-time on contact create, update, or delete

Event sync

Event sync sends your organization’s events to Salesforce as Campaigns, so you can track which leads came from which show.
  • When an event is created or edited in Wave Connect, a Campaign with the same name, dates, and description is created or updated in Salesforce. If a Campaign with exactly the same name already exists, Wave Connect links to it instead of creating a new one.
  • When a contact is added to an event, it is added to the Campaign as a Campaign Member (as a Lead or a Contact, depending on your record type). Members use the Campaign’s default member status.
  • When a contact is removed from an event, its Campaign Member is removed.
  • When you first connect, your existing events and their contacts are sent to Salesforce.
Event sync is on by default. To turn it off, open the integration’s Settings and switch off Event sync. It only runs while Contact sync is on, and it needs the default Events → Campaign Member row in the attributes mapping: if you remove that row, Campaigns are still created but get no members.
The Salesforce user who connects the integration must have the Marketing User checkbox enabled on their user record. Without it, Salesforce does not allow Wave Connect to create Campaigns, and events are not synced.
Deleting an event in Wave Connect does not delete its Campaign in Salesforce.

Features

  • Leads or Contacts: choose the Salesforce record type that fits your workflow.
  • Organization or team: connect Salesforce once for the whole organization, or per team.
  • Sandbox support: connect to a Salesforce sandbox environment for testing.
  • Import on connect: import all existing Wave Connect contacts on first connection.
  • Deduplication: a custom external ID field (WaveConnectId__c) is created automatically and used for upserts, so re-syncing never creates duplicates.
  • Owner assignment: contacts are assigned to the Salesforce user whose email matches the Wave Connect team member.
  • Attributes mapping: choose which Salesforce field each contact field, custom attribute, and qualifier syncs to.
  • Event sync: send events as Campaigns and their contacts as Campaign Members.

Manually adding the external ID field

Wave Connect normally creates the WaveConnectId__c external ID field automatically when you connect. You only need this step if you connect without a Salesforce admin account, since creating a custom field requires admin permissions. In that case, have your Salesforce administrator add the field manually as a backup.
1

Open the Lead object

In Salesforce Setup, open Object Manager and select the Lead object.
2

Check for the field

Under Fields & Relationships, check whether WaveConnectId__c already exists.
3

Create the field

If it doesn’t exist, click New, select Text as the field type, and name it so the API name is WaveConnectId__c.
4

Set field-level security

Confirm that Standard User has read/write access to the field.
5

Add to page layouts and save

Add the field to the relevant page layouts, then save.
If the field already exists, open it and select Set Field-Level Security to confirm Standard User has read/write access. For full details, see the Salesforce setup guide.

Limitations & requirements

  • The custom field WaveConnectId__c is created automatically on your Salesforce account. Do not delete or rename it. It is used for deduplication.
  • For Leads, the Company field is required by Salesforce. If a Wave Connect contact has no company, it defaults to N/A.
  • If Salesforce detects a duplicate via its duplicate rules, Wave Connect overrides the rule and saves the record.
  • Owner matching is by email. If no matching Salesforce user is found, the contact is saved without an owner.
  • Deleting a contact in Wave Connect also deletes its record in Salesforce while contact sync is on.
  • Event sync requires the connecting user to be a Salesforce Marketing User.

Disconnecting

Open the integration’s Settings and, under Disconnect Salesforce, click Disconnect. This removes the integration and revokes Wave Connect’s access. Records already synced to Salesforce are not deleted.