> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/data-connections/salesforce.md).

# Salesforce

Connect Telmai to Salesforce.

Telmai reads Salesforce objects as tables, signing in with a Salesforce user's password and security token.

## Before you connect

1. Create or choose a Salesforce user for Telmai with API access and read access to the objects you want to monitor.
2. Get the user's security token. See Salesforce's [Reset your security token](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm).

If your org restricts login IP ranges, allow Telmai's addresses. See [IP Allowlist](https://docs.telm.ai/telmai/api-reference/telmai-ip-list.md).

## Connection fields

On the **Connections** page, click **Add connection** and choose **Salesforce**. See [Add a connection](https://docs.telm.ai/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field                  | Description                                                                                                           |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Database or Schema** | The schema whose objects Telmai lists.                                                                                |
| **Login Url**          | The Salesforce login URL, for example `https://login.salesforce.com`, or `https://test.salesforce.com` for a sandbox. |
| **User**               | The Salesforce user name, for example `jane.doe@example.com`.                                                         |
| **Password**           | The user's password.                                                                                                  |
| **SecurityToken**      | The user's security token.                                                                                            |

## Asset fields

Click **Add assets** on the connection. See [Add assets](https://docs.telm.ai/telmai/connect-to-data.md#list-of-connectors-enabled-by-default).

The **Configure** step has no Salesforce-specific fields. Choose **Existing table** or **Custom query**; see [Connection Modes](https://docs.telm.ai/telmai/connect-to-data/connection-modes.md).
