Send a text message to a WhatsApp phone number. Supports up to 4096 characters and optional URL preview.

Send an image message to a WhatsApp phone number. Provide a publicly accessible image URL.

Send a video message to a WhatsApp phone number. Provide a publicly accessible video URL.

Send an audio message to a WhatsApp phone number. Provide a publicly accessible audio URL.

Send a document or file to a WhatsApp phone number. Supports PDF, Word, Excel, and other common formats.

React to a WhatsApp message with an emoji.

Mark an incoming WhatsApp message as read. This sends a read receipt to the sender.

List recent WhatsApp conversations. Only available when the webhook server is running and has received messages.

Get the message history for a conversation with a specific phone number. Requires webhook server.

Get the delivery/read status of a previously sent message. Requires webhook server for live updates.

[LEGACY / UNSUPPORTED] Look up a phone number to check if it has a WhatsApp account and retrieve the WhatsApp ID. This relies on the POST /{phone-number-id}/contacts 'contact check' feature of the legacy WhatsApp On-Premises API, whose final client version expired on 2025-10-23 (per Meta's On-Premises API Sunset). It was never part of the WhatsApp Cloud API used by this server and has no Cloud API equivalent, so it is not expected to work; it is retained only for backwards compatibility. To check deliverability, send the message and inspect message-status webhooks / error codes instead.

Retrieve the WhatsApp Business profile for your connected phone number, including about text, address, description, email, and website.

Update your WhatsApp Business profile. You can update the about text, address, description, email, website URLs, and business vertical.

Upload a media file from a URL to WhatsApp and get back a media ID. The media ID can then be used to send media messages. Supports images (JPEG, PNG, WebP), videos (MP4, 3GPP), audio (AAC, MP4, MPEG, AMR, OGG), and documents (PDF, Word, Excel, PowerPoint, plain text).

Get the download URL for a WhatsApp media file using its media ID. The URL is temporary and expires after 5 minutes. Use this to download received media.

Delete a previously uploaded media file from WhatsApp servers using its media ID. This frees up storage and removes the file permanently.

Send an approved WhatsApp message template. Templates are pre-approved messages used for business-initiated conversations. Supports header, body, and button components with dynamic variable substitution.

List available WhatsApp message templates for your business account. Shows template name, status (APPROVED/PENDING/REJECTED), category, and language. Requires WHATSAPP_BUSINESS_ACCOUNT_ID to be configured.