Send WhatsApp messages

post

https://api.tracksend.co/messaging/v1/whatsapp

Send an approved template to 1–100 recipients. Authenticate with Authorization: Bearer YOUR_API_KEY. A 202 response means queued, not delivered. Reuse the same Idempotency-Key for retries.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Send an approved dynamic template owned by the authenticated account. The template determines the connected business sender.

required

length ≥ 1

One recipient or 1 to 100 recipients. Numbers are normalized using countryCode. All recipients receive the same templateData or text.

countryCode

required

length ≥ 1

Country dialing code, such as 234, as a string or integer. A two-letter ISO country code such as NG is also supported.

callback

uri

^https?://

Optional HTTP or HTTPS URL without embedded credentials for asynchronous message-status callbacks.

metadata

string

Optional customer reference echoed in delivery callbacks.

templateCode

string

required

^w-.+$

Dynamic API template code: w- followed by the approved template ID.

templateData

object

Values keyed by the template variable bindings. Supply every required variable and no unknown keys. Values must be nonblank strings or numbers; zero is valid. Null, booleans, arrays and nested objects are rejected. Omit when the template has no variables.

mediaUrl

uri

^https?://

Optional public HTTP/HTTPS media URL without embedded credentials for an image, video or document template header. The file type must match the approved header. Omit to use the template default, when available.

Headers

Idempotency-Key

string

length ≤ 191

Client-generated key for safe retries. If omitted, Messaging generates one and returns it in the response header. Reusing a key with a different request returns 409.

Responses

202Submission accepted for asynchronous processing. HTTP 202 and queued recipient states do not confirm Meta acceptance or delivery. Examples are illustrative.

400Invalid JSON, unknown fields, or fields reserved for internal callers.

401Missing or invalid TrackSend API credentials; use the same authentication as SMS.

402Insufficient available wallet balance; no new message is accepted.

409The same Idempotency-Key was previously used with different request details.

422Recipient, sender, template, variable, callback, media or account-pricing validation failed. Error codes include invalid_request, invalid_recipient, invalid_whatsapp_template, invalid_whatsapp_sender, invalid_template_data, invalid_callback, invalid_media_url and pricing_unavailable.

429The shared tenant API request budget was exceeded. Retry-After is in seconds.

503The service is temporarily unavailable, the original request is still processing, or publication is unconfirmed/rejected. Preserve the original Idempotency-Key; do not create another intentional send to resolve an uncertain outcome.