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

Media requirements

Type	Formats	Max size	Notes
Standard Pin	JPEG, PNG	20 MB	1000 x 1500 px (2:3) recommended
Video Pin	MP4, MOV, M4V	2 GB	4 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 unsupported_platform_operation.
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.

Error	Cause	Fix
`400` with code `missing_required_field`	One of `headline`, `body`, `imageUrl` or `linkUrl` is absent	Send all 4; Pinterest builds the Pin from them.
`400` with code `invalid_field_value`	A `goal` outside the 4 Pinterest values, or a headline over 100 or a body over 500 characters	Use a supported goal and trim the copy.
`403` with code `ads_allowance_exceeded`	The team has no payment method on file and has reached 500 live ads	Add a card to resume creating ads.
`501` with code `unsupported_platform_operation`	`targeting` or `creative` sent to `PUT /v1/ads/{adId}`	Change status or budget, and recreate the ad for anything else.
`502` with code `platform_api_error`	Pinterest rejected the request	Read `platformError` for Pinterest's own payload.

A rejected create returns the flat envelope:

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

Error handling covers the envelope and the stable codes.

Type	Formats	Max size	Notes
Standard Pin	JPEG, PNG	20 MB	1000 x 1500 px (2:3) recommended
Video Pin	MP4, MOV, M4V	2 GB	4 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).

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 unsupported_platform_operation.
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.

Error	Cause	Fix
`400` with code `missing_required_field`	One of `headline`, `body`, `imageUrl` or `linkUrl` is absent	Send all 4; Pinterest builds the Pin from them.
`400` with code `invalid_field_value`	A `goal` outside the 4 Pinterest values, or a headline over 100 or a body over 500 characters	Use a supported goal and trim the copy.
`403` with code `ads_allowance_exceeded`	The team has no payment method on file and has reached 500 live ads	Add a card to resume creating ads.
`501` with code `unsupported_platform_operation`	`targeting` or `creative` sent to `PUT /v1/ads/{adId}`	Change status or budget, and recreate the ad for anything else.
`502` with code `platform_api_error`	Pinterest rejected the request	Read `platformError` for Pinterest's own payload.

A rejected create returns the flat envelope:

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

Error handling covers the envelope and the stable codes.