> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/integrations/salesforce.md).

# Salesforce

Sync fields from Salesforce Contacts, Leads, Accounts and Opportunities onto existing Jimo users, to segment and target on CRM data.

The Salesforce integration copies the Salesforce fields you choose onto your existing Jimo users, in near real time. You then segment and target experiences on CRM data.

## What it does

* **One way, Salesforce to Jimo.** Jimo does not write back to Salesforce.
* **Existing users only.** Records sync only when the matching user already exists in Jimo. No user or record is created in either tool.
* **Four object types.** Contacts, Leads, Accounts and Opportunities.
* **Near real time.** A record created or updated in Salesforce updates the matched user.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FMIORoAXDJ5rU9fNntNFj%2FF2-54b-crm-flow-salesforce.png?alt=media&amp;token=6d93ec4d-bffb-42f3-b756-e66926aa7cfa" alt="Salesforce records are matched to existing Jimo users on email or your user ID; mapped fields become attributes with the Salesforce icon, in near real time. A record with no match is skipped, and nothing is written back to Salesforce"><figcaption></figcaption></figure>

## Before you start

* A Salesforce account you can authenticate with.
* Users already identified in Jimo. See [Identify your users](https://help.usejimo.com/docs/getting-started/install-jimo/identify-your-users.md).
* A matching field present in both tools: email, or a custom ID field that exists in Salesforce.
* A Jimo role with access to the Integrations settings. See [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md).

## Connect

{% stepper %}
{% step %}

### Connect Salesforce

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), hover the Salesforce card, click **Enable**, then connect from the setup page.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F1QIQuFqIJSpq55nyHmoh%2Fimage.png?alt=media&amp;token=9a311c0f-7e93-48a9-94fc-5c5fb9408cdc" alt="Salesforce card in Settings > Integrations"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Authenticate

Sign in to Salesforce and choose the account to sync from.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FBbbI5MbAVEPzVlRiwQdP%2Fimage.png?alt=media&amp;token=dcaa5e93-43e0-417e-aeed-acf2d04a8cd7" alt="Salesforce authentication"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose the matching field

Pick the Salesforce field and the Jimo field that identify the same person. Email is the default. A custom ID field works too, as long as it exists in Salesforce.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FlsMALxpD9ktyi67x5tjR%2Fimage.png?alt=media&amp;token=3b007190-4380-435e-be7d-39d90148239e" alt="Matching field between Salesforce and Jimo"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Map the fields

Choose the fields from Contacts, Leads, Accounts and Opportunities. For each one, select a Jimo attribute, or type a new name and press Enter to create it.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FSWGlcAnqD4rTvWZJoTWb%2Fimage.png?alt=media&amp;token=bb5bbf1f-d087-43f9-a910-e342074083e1" alt="Field mapping, Salesforce on the left, Jimo attribute on the right"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Run a full sync

Run a full sync to populate the attributes of your existing users.
{% endstep %}
{% endstepper %}

## What flows into Jimo

| What                                | When                     | Where you see it                            |
| ----------------------------------- | ------------------------ | ------------------------------------------- |
| Mapped fields of matched records    | On create or update      | On the user profile, with a Salesforce icon |
| Past values of a newly mapped field | When you run a full sync | Same                                        |

Use the synced attributes in [Who](https://help.usejimo.com/docs/publish/target-right-people-who.md) and in [segments](https://help.usejimo.com/docs/analyze/users-and-segments/audience/segments.md).

## Verify

Open a user you know is in Salesforce in [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md). The mapped fields show on the profile with the Salesforce icon. If they are empty, run a full sync, then check the matching field.

## Limits

#### No write-back to Salesforce

Jimo does not push usage or engagement data to Salesforce. To send Jimo events there, have your backend receive [webhooks](https://help.usejimo.com/docs/integrations/webhooks.md) and call the Salesforce API.

#### Unmatched records are skipped

A Salesforce record with no matching Jimo user is ignored.

## Stop the integration

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), open Salesforce and click **Delete**. The sync stops right away.

## Related

* [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md): the mapping pattern shared with HubSpot
* [HubSpot](https://help.usejimo.com/docs/integrations/hubspot.md)
* [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md)
