Upload WhatsApp template header media | Teekrr

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