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
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 The step is done when
connect=ok when the connection saved, or connect=error&reason=... when it didn’t. Whatever the page shows, check the result: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
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 The step is done when no listing is
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: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.
last_error names what’s missing.
What the status means
Troubleshooting
authorize_urlfails with422. 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. Thereasonsays why.invalid_statemeans 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. Checkconnection.statusand reconnect if it isn’tconnected.