---
title: "Send WhatsApp Session Message V2"
method: POST
path: "/v2/whatsapp/session-message/send"
tags: ["WhatsApp Session Message"]
---

# Send WhatsApp Session Message V2

`POST /v2/whatsapp/session-message/send`

## Request

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

This method allows you to reply to contact's messages within a 24-hour window.<br>

**API Update Notice:** This V2 endpoint is the recommended version, replacing the previous V1 endpoint. We recommend migrating to V2 immediately for a better experience.<br>

Benefits of V2:
- Decreased processing time for API requests and responses
- Improved features: Blocking Request, Spam Check, and Blocked Numbers
- Increased RPS (from 30 RPS to 50 RPS)
- Better developer environment to support future developments
- Improved logging and monitoring
- Improved dependencies and service stability<br>

A rate limit of 50 RPS is applied to WhatsApp services. Verihubs also applies rate limits divided into several categories based on product. For more details, see [Rate Limit](https://docs.verihubs.com/docs/rate-limit).

#### Callback Description
When you want to use callback_url payload, you only need to put for example 
```
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
```

Payload       | Description          |
-----------|:---------------------|
session_id        | ID of the specific message            | 
status        | Latest status of the request             |

#### Callback Status Description

Status       | Description          | Condition |
-----------|:---------------------|:-------------------------- |
0        | Requested              | Message has been requested. |
1        | Sent                   | Message has been sent to Whatsapp server. |
2        | Delivered              | Message has been delivered to user. |
3        | Read                   | Message has been read by user. |
6        | Failed                 | Whatsapp cannot send Message to destination number |
7        | Request Error          | Verihubs cannot reach WhatsApp |
10       |  Tier Limit Exceeded   | Exceeding channel tier limit |

## Headers

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

## Request body

- SendWhatsappSession
  - `msisdn` string, required: Destination Phone Number. You need to include international prefix number.
  - `content` string, required: Message that wants to be sent. The content must be a minimum length of 1 character to a maximum length of 4096 characters.
  - `callback_url` string: Optional. This URL will be called by the server when the desired event will occur.

## Response `201`

Successful Request

- ResponseSendWhatsappSession
  - `code` integer, required: Code **(to be deleted on November 30, 2022)**
  - `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
- `403`: Forbidden
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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