cover_image_urlFix inputPinterest video upload is missing a cover image URL.
Provide a JPG or PNG cover image URL with every video pin.
user-error
Error reference
Pinterest API errors and troubleshooting
Understand Pinterest API errors for pin creation, board access, OAuth, media URLs, video cover images, content types, processing, and rate limits. Use this guide to decide whether to reconnect Pinterest, fix board selection, replace media, or retry after throttling.
Last updated: May 2026
8 documented error patterns across 4 categories
Clear guidance on reconnecting, retrying, replacing media, or changing content
Official platform references plus bundle.social production troubleshooting notes
Error categories
Find the failure type first
8 documented errors
All error codes
Codes, causes, and fixes
Video
2 mapped cases
cover_image_content_typeFix inputPinterest video upload is missing cover image content type.
Send the cover image content type together with the cover image URL.
user-error
Authentication
2 mapped cases
unauthorizedReconnectPinterest rejected the access token.
Reconnect Pinterest and create a fresh token.
refresh-token
invalid tokenReconnectThe Pinterest token is invalid or expired.
Reconnect the user and retry with a valid token.
refresh-token
Rate Limit
2 mapped cases
429Retry laterPinterest rate limited the request.
Wait for the rate-limit window to reset before retrying.
retry
rate limitRetry laterPinterest blocked the request for too many calls.
Throttle board, pin, and media operations with backoff.
retry
Media
2 mapped cases
invalid mediaFix inputPinterest rejected the media file.
Use supported image or video formats and upload a clean file.
user-error
unsupported formatFix inputPinterest does not support the media format.
Convert images to JPG or PNG and videos to an accepted MP4 or MOV export.
user-error
Authentication failed
Pinterest rejects requests when the token is expired, revoked, or missing scopes required for boards, pins, or media.
Media URL unreachable
Pin creation depends on Pinterest fetching the image or video URL. A 403, redirect loop, or short-lived URL can fail.
Pinterest pin creation depends on board and media validation
Pinterest can reject a pin when the board is unavailable, the media URL cannot be fetched, the image or video format is unsupported, the video is missing a cover image, or the media has not finished processing.
Video pins need extra fields
Pinterest video publishing is more sensitive than image pins. Cover image URL, cover image content type, media processing state, and board compatibility should be checked before retrying a failed video pin.
How bundle.social helps
bundle.social separates Pinterest failures by OAuth, board access, image and video validation, cover image requirements, media URL fetching, duplicate resources, and rate limiting.
Retry safety
Retry only temporary platform failures, processing delays, timeouts, 5xx responses, and rate-limit errors after the platform allows it. Do not retry the same request when the failure is caused by expired tokens, missing permissions, unsupported media, invalid captions, duplicate content, account restrictions, or policy blocks. The same payload will usually fail again until the account, media, content, or platform-specific setting is fixed.
Official references
Platform APIs change. Use these links to confirm current error behavior and field support.
FAQ
Can Pinterest API error messages change over time?
Pinterest errors often depend on board access, pin type, media URL fetchability, and video requirements. Use the code together with the selected board, media kind, and upload status.
Should users reconnect the account for every failed post?
No. Reconnect Pinterest for invalid tokens or missing scopes. For cover images, unsupported media, board validation, media URL access, or rate limits, update the pin payload or wait before retrying.
Does bundle.social hide the native platform error?
bundle.social keeps Pinterest's API details available and shows whether a failed pin needs account auth, board cleanup, media replacement, video cover data, or slower retry handling.
Related
Keep researching
Build with less platform drag