OverviewProductsPlatformsAPI ReferenceResources

Media & limits

Pinterest Ads media requirements, what the integration does not support, and the errors it returns most often.


Media requirements

TypeFormatsMax sizeNotes
Standard PinJPEG, PNG20 MB1000 x 1500 px (2:3) recommended
Video PinMP4, MOV, M4V2 GB4 seconds to 15 minutes, 9:16 or 1:1

Creatives are fetched from the URL you pass, which must be public and return the media bytes (media uploads).

What you cannot do

Pinterest Ads through Zernio does not support:

  • Targeting or creative edits after creation. PUT /v1/ads/{adId} takes status and budget; targeting or creative returns 501 with code feature_not_available.
  • Campaign duplication. POST /v1/ads/campaigns/{campaignId}/duplicate returns 501 on Pinterest.
  • Ad-account scoping on the connect call, because Pinterest has no ads discovery.
  • Income tier, city and radius targeting. Regions, metros and postal codes are supported.
  • Catalog or shopping ads.

Common errors

ErrorCauseFix
400 with code missing_required_fieldOne of headline, body, imageUrl or linkUrl is absentSend all 4; Pinterest builds the Pin from them.
400 with code invalid_field_valueA goal outside the 4 Pinterest values, or a headline over 100 or a body over 500 charactersUse a supported goal and trim the copy.
403 with code ads_allowance_exceededThe team has no payment method on file and has reached 500 live adsAdd a card to resume creating ads.
501 with code feature_not_availabletargeting or creative sent to PUT /v1/ads/{adId}Change status or budget, and recreate the ad for anything else.
502 with code platform_api_errorPinterest rejected the requestRead platformError for Pinterest's own payload.

A rejected create returns the flat envelope:

JSON
{
  "error": "headline is required",
  "type": "invalid_request_error",
  "code": "missing_required_field",
  "param": "headline"
}

Error handling covers the envelope and the stable codes.

Was this page helpful?

On this page