---
title: "Send WhatsApp Message"
method: POST
path: "/v1/whatsapp/message/send/sandbox"
tags: ["Sandbox - WhatsApp Message"]
---

# Send WhatsApp Message

`POST /v1/whatsapp/message/send/sandbox`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/v1/whatsapp/message/send/sandbox`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

This method helps you to generate and send WhatsApp message to destination number in sandbox environment.

#### Callback Description
Callbacks requires the url to be filled on payload. 
```
your-callback-url.com/callback
```
Example callback that we'll send
```
your-callback-url.com/callback?session_id=d0f5fb5c-2d50-4d3f-aea7-20018ab15806&status=1
```

 To obtain the appropriate response, the payload input must adhere to the predetermined scenario. <br>
Input other than the scenario will be considered an Invalid Scenario <br>


#### Response & Status Description

Status       | Description          | Condition |
-----------|:---------------------|:-------------------------- |
6282123060001        | Success Payload      | 201 "Message sent successfully" |
6282123060002        | Bad Request          | 400 Validation error" |
6282123060003        | Invalid Header       | 401 "Authorization failed"  |
6282123060004        | insufficient quota   | 403 "Quota insufficient" |
6282123060005        | Blocked Msisdn       | 409 "Msisdn invalid: msisdn has been blocked" |
6282123060006        | Too Many Request     | 429 "Too many request in the allowed time frame" |

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Request body

- SendWhatsappMessage
  - `msisdn` string, required: Destination Phone Number. Scenario is the only valid msisdn to use. Any other msisdn format will be marked as Invalid.
  - `content` string[]: Optional. String that will replaced variable from Template. For example 'Hello {{1}}, thank you for your interest for our product. Contact us at {{2}} if you need additional help'. If you put Verihubs in payload array 1, it will change variable {{1}} to Verihubs.
  - `lang_code` string: Optional. Language code to send in a different language (need to be approved first too)
  - `callback_url` string: Optional. This URL will be called by the server when the desired event will occur.

## Response `201`

Successful Request

- ResponseSendWhatsappMessage
  - `message` string, required: Message
  - `msisdn` string, required: destination number with international prefix country code
  - `session_id` string, required: Generated ID which associated with verification request

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/sandbox-whatsapp-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/sandbox-whatsapp-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/sandbox-whatsapp-api-documentation/revisions/80813f4bc2e7?raw)