---
title: "Send WhatsApp Message"
method: POST
path: "/dev/whatsapp-session"
tags: ["Send Session Message"]
---

# Send WhatsApp Message

`POST /dev/whatsapp-session`

Send a text or media message. Select the specific schema from the dropdown in the Request Body to see valid parameters.

## Query parameters

- `phone_number_id` string, required
- `to` string, required

## Headers

- `Authorization` string, required

## Request body

- union
  - FormatText
    - `type` 'text', required
    - `text` string, required — The body of the text message
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatImage
    - `type` 'image', required
    - `url` string, uri, required — Direct link to the image (JPEG, PNG)
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatDocument
    - `type` 'document', required
    - `url` string, uri, required — Direct link to the document
    - `document_filename` string, required — The name of the file as it will appear on WhatsApp
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatAudio
    - `type` 'audio', required
    - `url` string, uri, required — Direct link to the audio file
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatVideo
    - `type` 'video', required
    - `url` string, uri, required — Direct link to the video (MP4, 3GP)
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatLocation
    - `type` 'location', required
    - `latitude` string, required
    - `longitude` string, required
    - `name` string
    - `address` string
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatSticker
    - `type` 'sticker', required
    - `url` string, uri, required — Direct link to the sticker (WebP)
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
  - FormatReaction
    - `type` 'reaction', required
    - `message_id` string, required — ID of the message to react to
    - `emoji` string, required
    - `udf1` string — User Defined Field 1 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf2` string — User Defined Field 2 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.
    - `udf3` string — User Defined Field 3 – Optional custom value passed via API and returned in the webhook for your internal reference or tracking.

## Response `200`

Message Sent Successfully

- object
  - `status` string

---

[API](https://skmtc.dev/fast2sms/apis/dlt-sms-api.md) · [All operations](https://skmtc.dev/fast2sms/apis/dlt-sms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fast2sms/dlt-sms-api/revisions/1fd5abcff71a/schema)