Upload a campaign's header media

POST 
/broadcasts/media

Uploads to Meta, through the campaign's number, the template header's image, video or document. Send the file bytes as the body, with the name in X-File-Name, and use the returned id as variables.headerMedia.id. Meta keeps the media for 30 days.

Request

Responses

201

Created.

401

Missing, malformed, unknown or revoked token (authentication), or a suspended account (tenant_inactive).

402

No entitlement (payment_required). The body carries the reason in reason and the way out in action: what to do (kind) and the dashboard page where it is done (url).

404

Resource does not exist (not_found).

415

File type not accepted — only image (JPEG, PNG), video (MP4) and document (PDF).

429

Rate limit exceeded (rate_limit).

Response Headers

Retry-After

Seconds to wait before retrying.

X-RateLimit-Category

Which rate limit category applied — send, media or default.

X-RateLimit-Scope

Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).

X-RateLimit-Limit

Request ceiling for this category in the current window.

X-RateLimit-Remaining

Requests left in the current window.