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

# Salesforce connector

> Connect WRITER Agent to Salesforce to query CRM data, manage records, run reports, and automate workflows

This guide shows you how to configure the [Salesforce](https://www.salesforce.com/) connector for WRITER Agent. After setting up this connector, WRITER Agent can query and manage CRM records, run reports and dashboards, execute SOQL/SOSL searches, trigger workflows and approvals, invoke actions, perform bulk data operations, and interact with Chatter—automating CRM workflows and generating insights directly from your Salesforce environment.

## Install the Writer app from Salesforce AgentExchange

Before configuring the connector in AI Studio, install the Writer Salesforce Connector package in your Salesforce org from AgentExchange. A Salesforce admin must complete this step.

1. Go to the [Writer for Sales Personalization](https://appexchange.salesforce.com/appxListingDetail?listingId=68c1909f-4f6e-45cb-a07f-35afbeb421e5) listing on Salesforce AgentExchange
2. Select **Get It Now**
3. Select the Salesforce account to install the package into, then select **Install in Production**
4. Review the installation details, select the checkbox to agree to the terms and conditions, then select **Confirm and Install**
5. Log in to Salesforce when prompted to continue the installation
6. Select **Install for All Users**, then select **Install**
7. Wait for the installation to complete, then select **Done**
8. In Salesforce, go to **Setup** > **Installed Packages** and confirm that **Writer Salesforce Connector** appears in the list with a status of **Active**

## Set up the Salesforce connector

Configure the Salesforce connector in [AI Studio](https://app.writer.com/aistudio) under **Connectors & Tools**. The Salesforce connector uses WRITER-managed OAuth authentication—no OAuth app creation required.

<Note>
  The Salesforce connector uses WRITER-managed OAuth. Users authorize access to their Salesforce account when they first use the connector. No additional setup is required beyond the steps below.
</Note>

### Configure Salesforce

Before connecting, verify the following in your Salesforce environment:

1. Confirm that the Salesforce user account has API access enabled
2. Verify the user has appropriate permissions for the objects and operations you plan to use
3. Ensure any required Salesforce features (reports, Chatter, Bulk API) are enabled for your org

### Configure the connector in AI Studio

1. Navigate to **Connectors & Tools** in [AI Studio](https://app.writer.com/aistudio)
2. Select the Salesforce connector
3. Select who has access by default (all users or specific teams)
4. Select the connection level: User level (each user authenticates their own account) or org level (shared connection to a single account)
5. Select which tools to enable for your agents
6. Complete the OAuth authorization flow

## Next steps

* [Set up connectors](https://support.writer.com/article/299-setting-up-connectors): Learn how to configure and enable connectors in AI Studio
* [Tool calling guide](/home/tool-calling): Understand how AI agents use tools in conversations
* [WRITER Agent guide](https://support.writer.com/article/293-how-to-use-action-agent): Learn how to use WRITER Agent with connected tools
* [MCP gateway overview](/home/mcp-gateway): Learn about Writer's MCP gateway architecture