Skip to main content
Connecting Pinterest sends your Fluid products to the catalog on your Pinterest business account, where they appear as shoppable Pins. Buyers check out on your Fluid storefront, so there are no Pinterest orders to import. Setup takes a person in a browser for one step: approving Fluid’s access in Pinterest. Every other step is an API call.

Before you start

  • A Pinterest business account, and a person who can sign in to it.
  • The Pinterest account isn’t connected to another Fluid company. One account connects to one company.
  • A Fluid API token for the company with company admin access: Company settings permission to connect and disconnect, and Products permission to publish products. The examples use it as $FLUID_TOKEN.
  • A live company. A test store can’t connect a sales channel.

Steps

1

Start the connection

The response’s url is the Pinterest sign-in link. Nothing changes in Fluid until someone approves it in the next step. Open the link yourself, or send it to the person who will approve it. The link works once and expires after 10 minutes; call authorize_url again for a new one.
2

Approve Fluid in Pinterest

Sign in with the Pinterest business account and approve the access Fluid asks for: reading the account, and reading and writing its catalogs.Pinterest then sends the browser back to Fluid admin. The address ends in connect=ok when the connection saved, or connect=error&reason=... when it didn’t. Whatever the page shows, check the result:
The step is done when connection.status is connected. connection.account_name names the Pinterest account Fluid connected.
3

Publish products

This changes live configuration: it adds products to your Pinterest catalog. Start with a few products if you haven’t sold on Pinterest before.
Fluid creates one listing per product and publishes it in the background. Products already on the catalog are skipped, so sending the same IDs again is safe.
4

Check the catalog

Repeat until no listing is draft or pending and no audit_status is auditing. Each listing becomes active once Pinterest ingests it, with audit_status approved. The list is newest first, 25 per page; pass meta.pagination.next_cursor back as page[cursor] for the next page, or filter[product_id] to check one product.
5

Fix rejected products

A listing with status publish_failed or audit_status audit_failed didn’t make it onto the catalog. last_error says why. Fix the product in Fluid, then retry the listing:
The step is done when no listing is publish_failed or has audit_status audit_failed.

What each product needs

  • A SKU on every active variant, unique across the products you list on Pinterest.
  • A title, description and price. A product with no image of its own is sent with your company’s fallback image, which Pinterest may reject.
A product missing one of these fails to publish, and last_error names what’s missing.

What the status means

Troubleshooting

  • authorize_url fails with 422. Fluid couldn’t start the connection. A test store gets this every time. Otherwise contact Fluid support.
  • The address after approving ends in connect=error. The reason says why. invalid_state means the link was used twice or expired: start again for a new one.
  • The reason is no_account. Pinterest didn’t return a usable account. Sign in with a Pinterest business account and start again.
  • The reason is account_already_connected. Another Fluid company already holds this Pinterest account. Disconnect it there first.
  • A call fails with 404. The company has never connected Pinterest. Run step 1.
  • A call fails with 403. Your token lacks the permission that call needs: Company settings for the connection, Products for products.
  • Publishing or retrying fails with 422. The connection isn’t active, or the listing can’t be retried. Check connection.status and reconnect if it isn’t connected.

Remove products and disconnect

To take one product off Pinterest, delete its listing. This removes its items from your Pinterest catalog:
To disconnect:
Disconnecting leaves your catalog Pins on Pinterest, but Fluid stops syncing products until you connect again. Remove the listings first if you want the Pins gone.

API reference