Send Whatsapp Direct Send Message

Sends a free-form text message to a customer whose 24-hour service window has closed, without a pre-approved template.

Before you call

  • Direct Send must be provisioned and switched on for the sending WhatsApp number.
  • to is required: the customer's phone number with country code. Direct Send is 1:1 only, so groupId is rejected.
  • from is optional. If omitted, your organisation's default connected WhatsApp number is used.
  • content.text is required and cannot be blank.

How it works

  • If the customer's 24-hour window is still open, the message is sent as an ordinary session message instead.
  • Returns 422 DIRECT_SEND_NOT_ELIGIBLE when Direct Send is not provisioned, switched off, or paused by Meta for the number.
  • Fails if from is not one of your WhatsApp numbers or is disconnected.
  • The response contains recipient, status and messageId. Use the messageId with Get Message Status.

Rate limit

  • 500 requests per hour.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
length between 10 and 15

The phone number of the WhatsApp channel to send from, with the country code. Defaults to the organization's primary channel.

string
required
length between 10 and 15

The phone number to which the message is sent, with the country code.

string
length between 36 and 36

Message ID (UUID v4) to be used for the message. If not provided, a random UUID v4 will be generated

content
object
required

Text message to be sent

Responses
201

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json