> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversion Activity in Salesforce

> Show a lead's Conversion activity on Lead, Contact, and Account pages in Salesforce.

The **Conversion Activity** component shows Conversion activity on Lead, Contact, and Account record pages in Salesforce: emails, page visits, form submissions, campaigns, and custom events. Reps see a lead's engagement where they already work, without a Conversion seat.

![Conversion Activity timeline on a Contact record](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/timeline.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=6a0b63ce38cebdcfde114a6c97bc4267)

## Set up the activity timeline

### Before you begin

* The Salesforce sync is connected. See [Admin User Setup](https://docs.conversion.ai/product-docs/sync/salesforce/setup/admin-user-setup.md) or [Integration User Setup](https://docs.conversion.ai/product-docs/sync/salesforce/setup/integration-user-setup.md).
* You're a Salesforce System Administrator.
* You're an administrator in your Conversion workspace, so you can create an API key.

One Conversion API key serves your whole Salesforce org. Salesforce decides who sees activity: a user needs the **Conversion Activity Viewer** permission set and read access to the record.

***

### Step 1: Install or upgrade the Conversion package

Open the package install link from [Install the Salesforce package](https://docs.conversion.ai/product-docs/sync/salesforce/setup/admin-user-setup.md#step-2-install-the-salesforce-package). If your org already has the package, choose **Upgrade**.

***

### Step 2: Turn on callouts

Salesforce turns callouts off when it installs or upgrades the package. The component can't reach Conversion until you turn them back on.

**1. Open Named Credentials**

In Salesforce, click the gear icon → **Setup**. In **Quick Find**, enter "Named Credentials" and click **Named Credentials**.

![Quick Find showing Named Credentials](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/named-credentials-quick-find.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=6059785098c398ae4924e14fcd17ebb0)

**2. Open Conversion API**

Click **Conversion API**.

![Named Credentials list with Conversion API](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/named-credentials-list.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=9528290277566b3beabebc4fd73dad04)

**3. Turn on Enabled for Callouts**

1. Click **Edit**.
2. Turn on **Enabled for Callouts**.
3. Click **Save**.

![Edit Conversion API dialog with Enabled for Callouts turned on](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/named-credential-enable-callouts.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=4d6205756c7b1d0416593c9100449f5e)

**4. Check the setting**

**Enabled for Callouts** shows as on.

![Conversion API named credential with callouts enabled](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/named-credential-enabled.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=687751368c92f03db56ecaed700d3712)

> [!NOTE]
>
> Check this setting again after every package upgrade.

***

### Step 3: Create a Conversion API key

In Conversion, go to **Settings** → **Integrations** → **API** and click **Add API key**. Name it "Salesforce" and copy the key. See [API](https://docs.conversion.ai/product-docs/workspace-settings/integrations/api.md).

***

### Step 4: Give yourself the Conversion Admin permission set

The **Conversion Admin** permission set shows the **Conversion Setup** tab, where you save the key.

**1. Open Permission Sets**

In **Setup**, enter "Permission Sets" in **Quick Find** and click **Permission Sets**.

![Quick Find showing Permission Sets](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-sets-quick-find.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=74ce9c13a7e1a88a8513ddf98b377a36)

**2. Open Conversion Admin**

Click **Conversion Admin**. The package adds two permission sets: **Conversion Admin** and **Conversion Activity Viewer**.

![Permission Sets list](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-sets-list.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=676f811112c5244ba08e8edb36cea894)

**3. Assign it to yourself**

1. Click **Manage Assignments** → **Add Assignment**.
2. Check the box next to your name and click **Next**.
3. Leave **No expiration date** selected and click **Assign**.
4. Click **Done**.

The screenshots in Step 6 show each of these screens.

***

### Step 5: Save the key

**1. Open the Conversion Setup tab**

Click the App Launcher, search for "Conversion", and click **Conversion Setup**.

![App Launcher search showing Conversion Setup](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-launcher-conversion-setup.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=edaf2f1ee0e3432da29b88e1f1c19e3d)

Before a key is saved, **Connection** says **Not connected. Save a Conversion API key to connect.**

![Conversion Setup tab before a key is saved](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/conversion-setup-tab.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=a45a3b105c77c3f7b466f297ddc2540c)

**2. Paste the key**

Paste the key from Step 3 into **Conversion API key** and click **Save**.

![Conversion API key entered](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/conversion-setup-key-entered.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=08bf8ad8cf848c4a0a200ae559dddba3)

**3. Check the connection**

**Connection** shows **Connected to the Conversion workspace** and your workspace name. Click **Test connection** to check again later.

![Conversion Setup tab connected to a workspace](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/conversion-setup-connected.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=82210502118f4ae0eaf5d32cb3d65164)

Salesforce stores the key encrypted, and it can't be read back. Saving a new key replaces the old one.

***

### Step 6: Give users access

Assign **Conversion Activity Viewer** to everyone who should see Conversion activity.

**1. Open Conversion Activity Viewer**

In **Setup** → **Permission Sets**, click **Conversion Activity Viewer**, then **Manage Assignments**.

![Conversion Activity Viewer permission set](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-detail.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=0c3e5873a21b9a3030eb1868912981c2)

**2. Add assignments**

Click **Add Assignment**.

![Current Assignments with the Add Assignment button](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-manage-assignments.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=b63a6cbda7f4b5fca1c267e9df583e74)

**3. Select users**

Choose a list view, such as **All Users**. Check the box next to each user and click **Next**.

![Users selected for assignment](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-select-users.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=30dfe31f600d2df9602eaf6775ff74b6)

**4. Assign**

Leave **No expiration date** selected and click **Assign**.

![Expiration options for the assignment](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-expiration.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=35ea5f8b3b6ff66ea740628fa05fd8a1)

**5. Finish**

Salesforce confirms the assignments. Click **Done**.

![Assignment Summary showing success](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-assigned.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=dc436016e5c1942c7427bc67497eb7b0)

The users appear under **Current Assignments**.

![Current Assignments listing the assigned user](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/permission-set-current-assignments.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=ee2c35e7ed6ce74719d04e97bf53b612)

***

### Step 7: Add the component to your record pages

Do this once each for a Lead, a Contact, and an Account.

**1. Open a record**

Open any Lead.

![Lead record page](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/lead-record-page.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=5ff32e1c3052ec7ed6c16e5ff65ab66b)

**2. Edit the page**

Click the gear icon → **Edit Page**. Lightning App Builder opens.

![Gear menu with Edit Page](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/lead-edit-page-menu.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=da9ddb1a0021488a65e9c40bdf92b450)

![Lightning App Builder](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=1d8aaec89a4d96eb0a4284cf3f5b4c6d)

**3. Find the component**

In **Components**, search for "Conversion". **Conversion Activity** appears under **Custom - Managed**.

![Component search showing Conversion Activity](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-search-component.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=9ce56988577302e4648707429c703760)

**4. Add it to the page**

Drag **Conversion Activity** onto the page. Click it to set its properties.

![Conversion Activity added to the page with its properties](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-component-added.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=84eb8efd9d4253cc8dd4af5be5c1b605)

| Property | What it does |
| - | - |
| **Title** | The card's title. Defaults to "Conversion Activity". |
| **Items per page** | How many entries load at a time, from 1 to 100. Defaults to 20. |
| **Show Open in Conversion link** | Adds a link to the record in Conversion, and an icon on each email, form, and campaign entry that opens it in Conversion. Only users with a Conversion seat can open them. |

**5. Save**

Click **Save**. If Salesforce asks you to activate the page, click **Activate**. If it doesn't, the page is already active and you're done.

![Page Saved dialog with Activate](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-page-saved.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=8447dfd669381bb0cec4f9391c4528a6)

**6. Activate the page**

Click **Assign as Org Default**.

![Activation dialog](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-activation.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=9463a65396b43d358d67ddc6716e5d24)

Choose the form factors your users need and click **Next**.

![Assign form factor dialog](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-form-factor.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=5c0b1673f5035e27695869573cb77a60)

Click **Save**.

![Review assignment dialog](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/app-builder-review-assignment.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=f23e114999bd485224354378dd99edfc)

**7. Repeat for Contacts and Accounts**

Click the back arrow to leave App Builder, then repeat this step from a Contact and an Account.

## What the timeline shows

Activity is newest first. Click **Show more** to load older entries, and the refresh icon to reload.

![Conversion Activity timeline](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/timeline.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=6a0b63ce38cebdcfde114a6c97bc4267)

Use **Show** to filter by Emails, Page visits, Form submissions, Campaigns, Custom events, or Lead conversions.

![Show filter options](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/timeline-filter.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=b6ac0a370a3695f1b199681e46d4d2a4)

Click **Show details** on an entry for more about it, such as the pages in a visit or the answers in a form submission.

![A page visit with its details expanded](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/timeline-details.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=9187d52cc93a6a84b7172ceaaa5c3950)

| Record | Shows |
| - | - |
| Lead or Contact | That person's activity. A converted Lead shows the activity of the Contact it became. |
| Account | Activity from every contact in the matching Conversion company. Each entry shows the contact's email. |

A record appears once the Salesforce sync links it to Conversion. See [Contacts and Companies](https://docs.conversion.ai/product-docs/sync/salesforce/contacts-companies.md).

## Troubleshooting

| Message | What to do |
| - | - |
| Callouts are turned off. | Turn on callouts (Step 2). |
| Not connected. Save a Conversion API key to connect. | Save a key on the **Conversion Setup** tab (Step 5). |
| Conversion isn't connected yet. Ask your Salesforce admin to finish setup on the Conversion Setup tab. | An admin needs to finish setup. If setup is done, give the user the **Conversion Activity Viewer** permission set (Step 6). |
| This record isn't in Conversion yet. | The sync hasn't linked this record yet. Activity appears after the next sync. |
| You do not have access to this record. | The user needs read access to the record in Salesforce. |

With callouts off, the **Conversion Setup** tab says so under **Connection**:

![Conversion Setup tab with callouts turned off](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/conversion-setup-callouts-off.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=3ad67e678cd2b96f09b24ce58cb1d8bc)

Until setup is finished, or for a user without the **Conversion Activity Viewer** permission set, the component asks them to contact their admin:

![Lead page with the component before setup is finished](https://mintcdn.com/conversion/C_g8zYAyDjIGa8Z5/images/salesforce-activity/lead-not-connected.png?fit=max\&auto=format\&n=C_g8zYAyDjIGa8Z5\&q=85\&s=fca56bd2b47e10b68d0942ab52665dc5)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.