> ## Documentation Index
> Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Text messages

# Text messages

Updated: Nov 3, 2025

Text messages are messages containing only a text body and an optional link preview.

![](https://scontent-lax3-2.xx.fbcdn.net/v/t39.2365-6/440742591_797870012016470_1123226266833971975_n.png?_nc_cat=106\&ccb=1-7&_nc_sid=e280be&_nc_ohc=y-uFNDNxEogQ7kNvwENMXTp&_nc_oc=Adl98m6ORv8QnU3EBUV1GKCEJdQTI5V2bD1LAyIXarAc2SI9BrahT-KTCKu8A2Bl39Q&_nc_zt=14&_nc_ht=scontent-lax3-2.xx&_nc_gid=738ssB7x4RGVYq0Dt-oI9Q\&oh=00_Afl3pScWf_S8FRVNl_fIVz7BiA-XGAd8ZV-gggaL9by7qg\&oe=695501EB)

## Request syntax

Use the [POST /\<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/messages](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) endpoint to send a text message to a WhatsApp user.

```
curl 'https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \
-d '
\{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "&lt;WHATSAPP_USER_PHONE_NUMBER&gt;",
  "type": "text",
  "text": {
    "preview_url": &lt;ENABLE_LINK_PREVIEW&gt;,
    "body": "&lt;BODY_TEXT&gt;"
  }
}'
```

### Request parameters

| Placeholder                                               | Description                                                                                                                                                                                                                                                                                                       | Example Value                                                                                                                                                                                                                                    |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `&lt;ACCESS_TOKEN&gt;`<br />*String*                      | **Required.**<br />[System token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) or [business token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). | `EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD` |
| `&lt;API_VERSION&gt;`<br />*String*                       | **Optional.**<br />Graph API version.                                                                                                                                                                                                                                                                             | v24.0                                                                                                                                                                                                                                            |
| `&lt;BODY_TEXT&gt;`<br />*String*                         | **Required.**<br />Body text. URLs are automatically hyperlinked.<br />Maximum 4096 characters.                                                                                                                                                                                                                   | `As requested, here's the link to our latest product: https://www.meta.com/quest/quest-3/`                                                                                                                                                       |
| `&lt;ENABLE_LINK_PREVIEW&gt;`<br />*Boolean*              | **Optional.**<br />Set to `true` to have the WhatsApp client attempt to render a link preview of any URL in the body text string.<br />See [Link Preview](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/text-messages#link-preview) below.                                   | `true`                                                                                                                                                                                                                                           |
| `&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;`<br />*String* | **Required.**<br />WhatsApp business phone number ID.                                                                                                                                                                                                                                                             | `106540352242922`                                                                                                                                                                                                                                |
| `&lt;WHATSAPP_USER_PHONE_NUMBER&gt;`<br />*String*        | **Required.**<br />WhatsApp user phone number.                                                                                                                                                                                                                                                                    | `+16505551234`                                                                                                                                                                                                                                   |

## Link preview

You can have the WhatsApp client attempt to render a preview of the first URL in the body text string, if it contains one. URLs must begin with `http://` or `https://`. If multiple URLs are in the body text string, only the first URL will be rendered.

If omitted, or if unable to retrieve a link preview, a clickable link will be rendered instead.

## Example request

Example request to send a text message with link previews enabled and a body text string that contains a link.

```
curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "text",
  "text": {
    "preview_url": true,
    "body": "As requested, here'\''s the link to our latest product: https://www.meta.com/quest/quest-3/"
  }
}'
```

## Example response

```
\{
  "messaging_product": "whatsapp",
  "contacts": [\
    {\
      "input": "+16505551234",\
      "wa_id": "16505551234"\
    }\
  ],
  "messages": [\
    {\
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"\
    }\
  ]
}
```

Did you find this page helpful?

![Thumbs up icon](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)

![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

ON THIS PAGE

Request syntax

Request parameters

Link preview

Example request

Example response

***