My Pinterest account got disconnected

Symptom

Pins fail with error_code token_expired or token_revoked, or a call returns Pinterest account not found (404). Publishing to that account stops working.

Cause

PinBridge publishes using an OAuth token that Pinterest issued when you connected the account. That token can stop working:

• token_expired — the token reached the end of its life and could not be refreshed.
• token_revoked — access was revoked, usually because someone removed PinBridge from the Pinterest account’s connected apps, or changed the Pinterest password, or Pinterest invalidated the grant.

In both cases PinBridge can no longer act on the account until you reconnect it.

Fix

1. Reconnect the account. In PinBridge, start the Pinterest connect flow again for the affected account and complete the OAuth consent on Pinterest. Grant all requested permissions so you do not hit scope_missing afterward.
2. Confirm the connection. List your accounts and check the account is present and not revoked:

bash
curl -H "X-API-Key: $PINBRIDGE_API_KEY" \
"https://api.pinbridge.io/v1/pinterest/accounts"

3. Retry the failed pins. Reconnecting does not automatically re-publish pins that already failed. Retry them:

bash
curl -X POST -H "X-API-Key: $PINBRIDGE_API_KEY" \
"https://api.pinbridge.io/v1/pins/<pin_id>/retry"

For many pins, use POST /v1/pins/bulk-retry. See My pin failed.

Preventing it

There is no way to stop Pinterest from expiring or revoking a token, but you can catch it early: subscribe to the pin.failed webhook and watch for token_expired / token_revoked in the payload so you know to reconnect. See I’m not receiving webhooks.

Related

• My pin failed — read the pin’s error code.
• Error reference — 401, 403, and 404 account errors.
• Troubleshooting — all articles.