API ReferenceWhatsApp

Upload WhatsApp template header media

View as Markdown
Uploads a header asset (image, video, or document) to Teekrr-managed storage and returns its public URL. Pass the returned URL as the value of the template variable that represents the header - see the `variables` section of `POST /whatsapp`. **Required scope:** `send_whatsapp` **Rate limit:** no per-endpoint limit; the global 200 / 15 min per-IP limit applies. ## 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`. Maximum file size is **16 MB**. The multipart field name is `image` regardless of the media type being uploaded.

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. The IP whitelist, when set, is matched by **exact string equality** against the resolved caller IP - CIDR ranges are not supported. An empty whitelist allows any source address.

Request

This endpoint expects a multipart form containing a file.
imagefileRequired

Header media file (JPEG, PNG, WebP, MP4, or PDF), max 16 MB.

Response

Media uploaded
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error