Skip to main content

What it checks

Before registering the video upload, the publisher GETs pinterest.coverImageUrl. The response must:

Why

Pinterest fetches the cover image on its end during pin creation. If the URL is unreachable, returns 4xx/5xx, or serves something that isn’t an image, POST /v5/pins fails with a generic upstream error. Catching it locally points at the URL specifically.

Failure response

Remediation

  • Verify the URL is publicly reachable from outside your network (no auth, no IP allowlist).
  • Don’t use Google Drive share links, Dropbox preview URLs, or signed S3 URLs that have expired — same general failure mode as instagram.media.reachable (OAuthException 2207052).
  • When in doubt, upload the cover via POST /v1/media and use the returned public URL.