> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Salesforce user setup

## Overview\[#overview]

The Salesforce block allows you to do the following actions in
Salesforce:

* **Create a Case**: Seamlessly populate case fields in Salesforce with
  conversation content

* **Create a Lead**: Build out detailed leads with information collected
  from a chat

* **Check a Case**: Recall specific case information and share with a
  live chatter

Before you set up your Salesforce block, you will need to configure a
Salesforce user with the appropriate credentials and add API
permissions. To do so, follow the steps below!

## Configure a Salesforce User (With App Manager Permissions)\[#configure-a-salesforce-user-(with-app-manager-permissions)]

To configure a Salesforce user with app manager permissions, follow
these steps:

1. If you don't have a profile set up for the user, create a new
   profile with the Salesforce user license (found under
   *Administration* > *Users* in *Setup*).

2. To ensure the user has access on 'App Manager' option, request a
   Salesforce System Admin to give the **View Setup and
   Configuration**, **Customize Applications** and **Modify All Data
   Profile** Permission level.

3. If creating a new user, assign the profile from above to the new
   user (if you don't see the profile, make sure the license is set to
   *Salesforce*.)

4. Once you've created the user and verified the account, log in with
   it. If the profile has *API Only* enabled already, you will need to
   switch back to your admin account and log in to it through the *User
   Details* page.

5. Navigate to *Personal Settings/Setup*, and go to *My Personal
   Information* > *Reset My Security Token*.

6. Once you reset the token you should receive a new token via email.
   Be sure to save this in a safe place!

## Add API Permissions to a Salesforce User\[#add-api-permissions-to-a-salesforce-user]

To add API permissions, go to the Salesforce *User Profile.*

![](/_fern-files/_img/0cb4ac669125284a0b42bb00dea3632bd7b67036d5f0b43209c742a90db2bb06.webp)

1. In the *Profile Details* page, click **Edit**.

2. Ensure the following settings are in place:

   * In the *Administrative Permissions* section, check *API Enabled.*

   * In the *Administrative Permissions* section, *API Only User* can
     optionally be set (this will ensure the user can only be used with
     the API, and cannot log into Salesforce directly.)

   * Under *Standard Object Permissions* > *Cases: Read and Create
     permissions* should be granted.

   * Under *Standard Object Permissions* > *Leads: Read and Create
     permissions* should be granted.

   * In the *Password Policies* section, set *User passwords expires
     in* to *Never expires.* This ensures that the credentials
     configured in Ada will continue to be valid, allowing the
     Salesforce Block to continue functioning.

3. Click **Save**.

4. On the *Profile Details* page, under *Record Type Settings* >
   *Standard Record Type Settings* > *Cases*, make sure a default
   record type is set.

5. For fields you would like to populate via *Create Case*, you will
   need to set to *Edit Access.*

6. For fields you would like to query via *Check Case*, you will need
   to set to *Read Access*. Field access permissions can be set on the
   *Profile Details* page under *Field-Level Security* > *Standard
   Field-Level Security* > *Case*.

7. For fields you would like to populate via *Create Lead*, you will
   need to set up with *Edit Access*. Field access permissions can be
   set on the *Profile Details* page under *Field-Level Security* >
   *Standard Field-Level Security* > *Lead*.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).