Skip to main content
This guide walks you through connecting your Salsify organization to Profound. Once connected, Profound Agents can work with your Salsify Product Lists.
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.

​
Before you start

You’ll need:
  • Salsify account with permissions to create users, API keys, and Product Lists
  • Profound account

​
Setup guide

1

Create a Salsify user for Profound

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 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.
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.
2

Copy the API key

  • Sign in to Salsify as the user from 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.
3

Copy the organization ID

The organization ID is the segment of any Salsify URL that follows /orgs/. For example:
Copy your organization ID and keep it handy to use in later steps.
4

Copy the Product List IDs

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 documentation.Once you have your list ready, open it and copy the ID from the URL segment that follows product_lists/:
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.
5

Connect Salsify to Profound

  • 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 and the Organization ID from 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.
6

Verify the connection

To confirm that the Salsify user can reach the products your Agents will use, test the nodes in the Agent builder:

​
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

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.
  • Check that you copied the whole API key.
  • Confirm that nobody has disabled the Salsify 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.
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 of Profound’s user.
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.
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.