# Media & limits

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](/guides/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

| 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 `feature_not_available` | `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:

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

[Error handling](/guides/error-handling) covers the envelope and the stable codes.