Troubleshooting

Common problems and how to fix them. Each article follows the same shape: the symptom, the cause, the fix, and related links. For the full list of API errors by HTTP status, see the Error reference.

Publishing

• Why did Pinterest change my pin title? — Pinterest re-scrapes your destination page and can override the title from its OG tags.
• Why is my pin stuck in queued? — how queued and deferred work, and when a stuck pin is auto-recovered.
• Why did my pin fail? — read the pin’s error_code and error_message, then act on it.

Accounts and access

• Why did my Pinterest account get disconnected? — token_expired and token_revoked, and how to reconnect.
• Why am I getting 402 quota_exceeded? — monthly quota, credits, and upgrading.
• Why am I getting 403 plan_limit? — account, API key, and feature limits per plan.
• Why am I getting 401 Invalid API key? — the X-API-Key header and key scope.

Media, webhooks, and infrastructure

• My video upload failed. What now? — supported formats, plan-based size limits, and disk quota.
• Why am I not receiving webhooks? — enablement, 2xx responses, retries, and signatures.
• Is it safe that PinBridge uses shared IPs? — why shared server IPs are expected and not a risk.

Next steps

• Error reference — every API error by HTTP status.
• PinBridge for n8n — publish and schedule from n8n.