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

# Connect Salsify to Profound

> A guide on how to set up the Salsify integration and connect it to Profound Agents

This guide walks you through connecting your Salsify organization to Profound. Once connected, Profound Agents can work with your Salsify Product Lists.

<Note>
  Profound connects to Salsify at the organization level. One connected account gives every Agent in your Profound organization access to one Salsify organization, with the permissions of the Salsify user that owns the API key.
</Note>

## Before you start

You'll need:

* [Salsify](https://www.salsify.com/) account with permissions to create users, API keys, and Product Lists
* [Profound](https://www.tryprofound.com/) account

## Setup guide

<Steps>
  <Step title="Create a Salsify user for Profound" id="step-1">
    Profound acts in Salsify as the user that owns the API key, so Salsify applies that user's permissions to every request.

    * In Salsify, [create a dedicated user](https://help.salsify.com/ProductXM/s/article/manage-users-and-roles) for the integration, for example `profound-integration@yourcompany.com`.
    * Give the user access only to the products and Product Lists that you want to use with Profound.

    <Note>
      Creating a dedicated user for Profound is a good practice because it gives you one switch for the integration: disabling that user in Salsify disables the entire integration.
    </Note>
  </Step>

  <Step title="Copy the API key" id="step-2">
    * Sign in to Salsify as the user from [Step 1](#step-1).
    * Open your user profile menu and select **API Access**.
    * Select **Show API key**, copy the key, and store it securely in your secret manager.
  </Step>

  <Step title="Copy the organization ID" id="step-3">
    The organization ID is the segment of any Salsify URL that follows `/orgs/`. For example:

    ```text wrap theme={null}
    https://app.salsify.com/app/orgs/<ORGANIZATION_ID>/products
    ```

    Copy your organization ID and keep it handy to use in later steps.
  </Step>

  <Step title="Copy the Product List IDs" id="step-4">
    Profound reads products from and writes membership changes to Product Lists. Salsify's API doesn't let Profound create lists for you, so create them in Salsify first as instructed in Salsify's [Creating Product Lists](https://help.salsify.com/ProductXM/s/article/creating-new-products-lists) documentation.

    Once you have your list ready, open it and copy the ID from the URL segment that follows `product_lists/`:

    ```text wrap theme={null}
    https://app.salsify.com/app/orgs/s-1a2b3c4d5e6f7890/product_lists/<PRODUCT_LIST_ID>
    ```

    Depending on your organization, a Product List ID is either a number or a UUID with an `s-` prefix (for example, `s-123a-456b-789c-...`). Profound accepts both.

    Copy the ID and keep it handy to use in later steps.
  </Step>

  <Step title="Connect Salsify to Profound" id="step-5">
    * In Profound, select your organization name in the top-left corner of the platform, then select **Settings**.
    * In the left sidebar, select **Integrations** under **Account**.
    * Search for **Salsify**, select it, then select **+ Add account**.
    * In the **Connect Salsify** dialog, enter the **Salsify API key** from [Step 2](#step-2) and the **Organization ID** from [Step 3](#step-3).
    * Select **Connect account**.

    You can also connect Salsify directly in the Agent builder. Add a Salsify node, open the **Salsify Organization** dropdown in the node settings, and select **+ Add integration**.

    If your Salsify organization appears in the list of connected accounts, the connection was successful.
  </Step>

  <Step title="Verify the connection" id="step-6">
    To confirm that the Salsify user can reach the products your Agents will use, test the nodes in the Agent builder:

    * In Profound, [create a new Agent](https://help.tryprofound.com/articles/2212787792-create-an-agent), or open an existing Agent draft.
    * Add the Salsify [**List Products**](/integrations/salsify/using-salsify-in-agents#list-products) node, then select the connected Salsify organization.
    * Enter the source list ID from [Step 4](#step-4) under **Product Lists**.
    * Select **Test node** (the play <Icon icon="play" /> icon) and check that the output contains the products you expect.
    * If you intend to update products or lists with Profound Agents, test the [**Update Products**](/integrations/salsify/using-salsify-in-agents#update-products), [**Add Products to List**](/integrations/salsify/using-salsify-in-agents#add-products-to-list), and [**Remove Products from List**](/integrations/salsify/using-salsify-in-agents#remove-products-from-list) nodes the same way.
  </Step>
</Steps>

## Updating or revoking access

* To replace the API key or the organization ID, go back to **Integrations** > **Salsify** in Profound settings, select **Edit credentials** in the connected account's action **...** menu, enter the new values, and select **Update**.
* To revoke Profound's access, select **Revoke** in the same menu. Salsify Agent nodes stop running until you connect Salsify again.

## Troubleshooting

<AccordionGroup>
  <Accordion title="API Access tab is missing from your Salsify profile menu">
    Your Salsify user doesn't have permission to use the API. Ask your Salsify administrator to grant it or to create the Profound integration user for you.
  </Accordion>

  <Accordion title="Profound can't save the credentials">
    * Check that you copied the whole API key.
    * Confirm that nobody has [disabled the Salsify user](https://help.salsify.com/ProductXM/s/article/disable-user) that owns the key. Disabling a user removes their access to Salsify, and their API key stops working with it.
    * Confirm that the **Organization ID** is the URL segment after `/orgs/` (not the organization name), and that it belongs to the same organization as the API key.
  </Accordion>

  <Accordion title="The connection saves, but a node reports that access is denied">
    This can happen if your Salsify user doesn't have permissions to work with the products and lists the Agent uses. In Salsify, [review the permissions](https://help.salsify.com/ProductXM/s/article/granular-user-group-level-permissions) of Profound's user.
  </Accordion>

  <Accordion title="A node reports that the Salsify rate limit is reached">
    Salsify limits how many requests it accepts in a period of time. The error tells you how many seconds remain until the limit resets. Wait, then run the Agent again.

    To use fewer requests, read more products per page and run fewer Salsify nodes at the same time.
  </Accordion>

  <Accordion title="Requests to Salsify time out or can't connect">
    A timeout is often temporary, so running the node again should fix it. If your Salsify organization only accepts requests from allowlisted IP addresses, ask your Profound account team to route your organization's Salsify requests through a static IP address.
  </Accordion>
</AccordionGroup>