Skip to main content

How to integrate Wiza with Salesforce

How to sync leads and save contacts to Salesforce

Stephen Hakami avatar
Written by Stephen Hakami
Updated this week

This article will show you everything you need to know to integrate Wiza with Salesforce.

In this article:


Connecting your Salesforce Account

1. Click Integrate.

Integrate

2. Click Connect under Salesforce.

Connect

3. Log in to Salesforce.

Log into Salesforce


Field Mapping

Click Setup to customize how your Wiza data is imported into your Salesforce account.

Doing so will take you to the window below:

Lead mapping
  • Contacts saved on Wiza sync to Salesforce as either Leads or Contacts.

  • To change an existing field mapping, simply select the field you’d like to change and choose an alternative.

  • To map a new field, select Add new mapping, and select the Wiza and Salesforce fields to map.

If there is a Wiza field that you would like to import but cannot find an applicable Salesforce field, please consult your Salesforce admin about creating a custom field.

Custom Field Mapping

You can create custom Wiza fields. Let's say that you have a SF Field called “Source” that you would like to populate with the field “from Wiza” for all of the contacts that you import from Wiza.

To do this:

  1. At the bottom, click Map new field.

  2. Select Custom from the Wiza Field dropdown.

  3. Select the Salesforce field you would like to map to, in this case 'Lead Source'.

  4. On the right, select 'Set' and enter “from Wiza”.

  5. Select Save changes.

Now, every contact that you import from Wiza will include the value “from Wiza” within your SF Lead Source field. This makes filtering your existing SF database for contacts created by Wiza very easy.


Syncing your data

To sync your list:

  1. To sync contacts from a list: Go to Lists and select an option from the dropdown menu at the bottom of a list.

    Import list to Salesforce

    'Valid' includes emails that have been verified for deliverability. These emails are 97% deliverable.

    'Risky' = emails that Wiza couldn’t verify for deliverability. These are always free and do not use email credits.

    To learn more about valid and risky emails, click here.

  2. If you would like to only sync a select few people, click on your list to open the contact's browser. Then select the Sync option next to each contact.

    Sync contact


Settings

In the Settings section of your Wiza Salesforce integration, you can control how data is created, updated, and synced across your CRM. These settings ensure that data flows according to your organization’s needs and Salesforce rules.

settings

Apply my Salesforce settings to all users on this account
By enabling this option, the settings and field mappings you configure will automatically apply to all users in your Wiza account. This ensures consistency across your team when syncing data to Salesforce.

Apply my Salesforce settings to all users on this account.

Primary Object Type
Choose whether new records created in Salesforce through Wiza will be stored as Leads or Contacts (with Accounts).

  • Lead: Creates new records as Leads.

  • Contact: Creates new records as Contacts, which are linked to Accounts.

primary object type

This selection determines how new prospects are structured in your CRM.

Object Types to Update
Decide which existing Salesforce objects Wiza should look for when syncing new data:

  • Primary object type only: Wiza will only search within your selected primary object type (Lead or Contact).

  • All: Wiza will attempt to find and update existing Leads or Contacts. If no match is found, Wiza will create a new record using your primary object type.

Object types to update

This helps prevent duplicate records and ensures updates are applied wherever your contacts exist.

Update existing contacts regardless of ownership
When enabled, Wiza will update existing contacts in Salesforce even if they are owned by other users, as long as your Salesforce rules and permissions allow it.

Update existing contacts regardless of ownership.

Account Configuration
Control whether Wiza creates or updates Accounts in Salesforce:

  • Create new accounts: Wiza will create new accounts if one doesn’t exist.

  • Update existing accounts: Wiza will update account information when syncing.

Account configuration

These options depend on your Salesforce permissions and system rules, which may restrict when accounts can be created or updated.

Contact Configuration
Decide how Wiza handles associating Contacts with Accounts:

  • Associate contacts with accounts: Wiza will link Contacts to the appropriate Accounts in Salesforce.

  • Override existing account: If enabled, Wiza will replace the current Account associated with a Contact, if needed.

Contact configuration

This gives you control over how contacts are related to accounts within your CRM.

Primary Sync Method
If you’ve connected multiple tools to your Wiza account but want Salesforce to remain your main integration, set Salesforce as your Primary Sync Method.

To do this:

  1. Go to Integrate in the top menu of your Wiza dashboard.

  2. Toggle the Primary switch under Salesforce.

primary

Once set, you’ll see the Salesforce icon when syncing, confirming it as your primary integration.


Troubleshooting

  1. A contact/account is created but a property field is still blank

    • Depending on the field, there may not be a value available. To find out, download your list results to see if there is a property value for that contact. To see how to download your list, see this article.

    • Make sure your Salesforce Profile has the correct Field Access for that property. Open the Salesforce Object Manager to view field accessibility. To learn more, see this article.

    • Make sure the value complies with any Salesforce field validation rules.

      • There are many types of property fields in Salesforce. These include text, numerical values, dropdown select, dates, currencies, etc. For the full list, see this article.

      • Make sure that the value provided by Wiza is accepted in that Salesforce field. For example, if the Salesforce field is a picklist, the value provided by Wiza must be included as an option within that Salesforce field. To see how to edit your Salesforce fields, see this article.

  2. A contact already exists in Salesforce, but the properties are not being updated

    If a contact with the same email already exists, Wiza will add/update the value of the mapped fields under the following conditions:

    In Salesforce:

  • If the property field has no value, Wiza will update the property field.

  • If the property field already has a value, Wiza will only overwrite the existing value if the Overwrite setting is enabled, see above. If not, the existing value in Salesforce will remain

Still need help? Contact our support team via the live-chat or at hello@wiza.co

Did this answer your question?