Upload a file for a conversation

POST 
/inbox/conversations/:id/media

Send the file bytes as the body (not multipart), with the name in X-File-Name. The type is detected from the content: image (JPEG, PNG), sticker (WebP), video (MP4, 3GP), audio, PDF, Office documents and text. Limits: image 5 MB, video and audio 16 MB, document 100 MB, sticker 500 KB. Use the returned id as assetId in a kind: media reply.

Request

Responses

201

Message recorded.

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

409

The conversation's number is no longer connected (phone_unavailable).

413

Above the type's limit (media_too_large, with limit and kind).

415

File type not recognized (media_type_not_allowed).

422

Payload failed validation (invalid_request, detailed in issues) or was rejected by Meta (meta_error, with the original body in meta).

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.