Send Direct Send utility message (no template)

post

https://api.clint.digital/v2/messages/direct-send

Send a free-form WhatsApp Official utility message via Direct Send, without a pre-approved template. Requires the owner to have the WHATSAPP_OFFICIAL_DIRECT_SEND feature flag enabled and the WhatsApp Business Account not to be restricted; otherwise returns 403. Supports an optional header/footer, up to one CTA URL button OR up to three quick-reply buttons, and an optional validity window (ttl_seconds, 30s–12h). Returns immediately with QUEUED status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

channel_account_id

uuid

required

UUID of the WhatsApp Official channel account

contact_id

uuid

required

UUID of the contact to send the message to

body

string

required

length ≤ 1024

Utility message text (1–1024 characters)

header

string

length ≤ 60

Optional text header (max 60 chars). Requires at least one button — returns 400 otherwise (Meta only delivers header/footer on interactive messages).

footer

string

length ≤ 60

Optional footer (max 60 chars). Requires at least one button — returns 400 otherwise (Meta only delivers header/footer on interactive messages).

buttons

array of objects

Optional. Either exactly one URL button OR up to three QUICK_REPLY buttons — the two types cannot be mixed.

buttons

ttl_seconds

integer

30 to 43200

Optional validity window in seconds (30s–12h). Omit to use Meta's default; the message is discarded if not delivered within this window.

chat_id

uuid

Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

Headers

api-token

string

required

API Token

Responses

401

Authentication error - invalid or missing api-token

201Message queued for sending

400Validation error

403Direct Send not eligible for this owner (feature flag disabled) or WhatsApp Business Account restricted

404Resource not found