API ReferenceWhatsApp

Upload WhatsApp template header media

View as Markdown
Uploads a header asset (image, video, or document) to Teekrr-managed S3 and returns its public URL. Use the returned URL in the `variables.headerImage`, `headerVideo`, or `headerDocument` fields of `POST /whatsapp` and `POST /whatsapp/test`. **Required scope:** `send_whatsapp` ## Allowed MIME types | Type | MIME | | --- | --- | | Image | `image/jpeg`, `image/png`, `image/webp` | | Video | `video/mp4` | | Document | `application/pdf` | Files outside this set are rejected with `400 Bad Request — Only JPEG, PNG, WebP, MP4, and PDF files are supported`.

Authentication

AuthorizationBearer

Bearer API keys are issued from the in-app /api-management page. Each key has a permission scope (send_sms, send_whatsapp, send_email) and an optional IP whitelist.

Request

This endpoint expects a multipart form containing a file.
imagefileRequired

Header media file (JPEG, PNG, WebP, MP4, or PDF)

Response

Media uploaded
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error