Send WhatsApp test message | Teekrr

Sends a single template message directly via the META Cloud API, bypassing the broadcast pipeline. No broadcast row is created, no SQS enqueue, and no credit is consumed. Use this to verify your template + variables before launching a real broadcast.

Required scope: send_whatsapp Rate limit: 5 requests / 15 min / client

Your registered webhooks will still receive delivered / failed events for the test message — only broadcast accounting and billing are skipped.

Sends a single template message directly via the META Cloud API, **bypassing** the broadcast pipeline. No broadcast row is created, **no SQS enqueue**, and **no credit is consumed**. Use this to verify your template + variables before launching a real broadcast. **Required scope:** `send_whatsapp` **Rate limit:** 5 requests / 15 min / client Your registered webhooks will still receive `delivered` / `failed` events for the test message — only broadcast accounting and billing are skipped.

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 an object.

templateNamestringRequired1-512 characters

tostringRequiredformat: "^\+?[1-9]\d{6,14}$"

E.164-format phone number (digits only or with leading +).

variablesobjectOptional

Response

Test send delivered to META

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

1	curl -X POST https://api.teekrr.com/whatsapp/test \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"templateName": "welcome_promo_v1",
6	"to": "60123456789",
7	"variables": {
8	"body": [
9	"Test User",
10	"RM50 OFF"
11	]
12	}
13	}'

1	{
2	"data": {
3	"success": true,
4	"to": "60123456789",
5	"metaMessageId": "wamid.HBgLNjAxMjM0NTY3ODkVAgARGBI4MEYzNERDNkE3MzM3NEU3MEUw"
6	}
7	}