Available on the Pro, Teams, and Enterprise plans.
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.
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.
- 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.
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.
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 theWaveConnectId__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__cis created automatically on your Salesforce account. Do not delete or rename it. It is used for deduplication. - For Leads, the
Companyfield is required by Salesforce. If a Wave Connect contact has no company, it defaults toN/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.