---
title: "Send a Whatsapp campaign"
method: POST
path: "/campaign"
---

# Send a Whatsapp campaign

`POST /campaign`

Send Whatsapp messages to a single recipient. This is a paid service.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `from` string, required — The phone provided by the customer during the WABA account setup. It is the phone that receives the verification pin.
  - `to` string, required — The recipient of the message. Could be one of - phone number in international format. In this it should follow the guidelines of E.164 but leading 00 is as well accepted - group id
  - `text` string, required — The text to be sent. 4069 chars, UTF-8 support
  - `imageURL` string — the url of the location where the image is stored. http or https, ASCII char set, supported formats are png, jpeg. Post-Processing Media Size 5MB.
  - `videoURL` string — the url of the location where the video file is stored. http or https, ASCII char set, supported formats video/mp4, video/3gpp. Post-Processing media size 16MB.
  - `documentURL` string — the url of the location where the document is stored. Any valid MIME-type is supported, post-Processing Media Size 100 MB.
  - `filename` string — File name of the document to be shown. It is shown on the uploaded document when the channel supports this. Max 512 chars, UTF-8.
  - `caption` string — Additional caption for the image / document / video. It is shown on the uploaded image / document / video when the Whatsapp supports this. Max 512 chars, UTF-8
  - `audioURL` string — the url of the location where the audio file is stored. Supported content is audio/aac, audio/mp4, audio/amr, audio/mpeg, audio/ogg; codecs=opus Note: The base audio/ogg type is not supported. Post-Processing Media Size 16MB
  - `stickerURL` string — the url of the location where the sticker is stored. http or https, ASCII char set. Supported formats image/webp, post processing media size 100KB.
  - `longitude` number, double — Longitude part of the coordinate. +/-180
  - `latitude` number, double — Latitude part of the coordinate. +/-180
  - `locationName` string — Optional name of location. 256 chars.
  - `locationAddress` string — Optional address, will only be rendered if name is set. 256 chars.
  - `template` object — The message template to be send.
    - `templateID` string — The template ID
    - `language` object
      - `code` string — The code of the language or locale to use. Accepts both language and language_locale formats (e.g., en and en_US).
    - `parameters` string[] — Array of free form params

## Response `200`

200

- object
  - `trackingId` string
  - `createdAt` string

## Other responses

- `400` — 400
- `403` — 403

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)