---
updatedAt: 2026-04-22T04:40:55.000Z
agentTools:
  projectIndex: https://docs.verihubs.com/llms.txt
---

# Send WhatsApp Message V2


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" |


# OpenAPI definition

````json
{
  "openapi": "3.0.2",
  "servers": [
    {
      "url": "https://api.verihubs.com/"
    }
  ],
  "info": {
    "title": "Sandbox - WhatsApp API Documentation",
    "version": "2.0.0"
  },
  "tags": [
    {
      "name": "Sandbox - WhatsApp Message"
    }
  ],
  "paths": {
    "/v2/whatsapp/message/send/sandbox": {
      "post": {
        "tags": [
          "Sandbox - WhatsApp Message"
        ],
        "summary": "Send WhatsApp Message V2",
        "description": "\nThis method helps you to generate and send WhatsApp message to destination number in sandbox environment.\n\n#### Callback Description\nCallbacks requires the url to be filled on payload. \n```\nyour-callback-url.com/callback\n```\nExample callback that we'll send\n```\nyour-callback-url.com/callback?session_id=d0f5fb5c-2d50-4d3f-aea7-20018ab15806&status=1\n```\n\n To obtain the appropriate response, the payload input must adhere to the predetermined scenario. <br>\nInput other than the scenario will be considered an Invalid Scenario <br>\n\n\n#### Response & Status Description\n\nStatus       | Description          | Condition |\n-----------|:---------------------|:-------------------------- |\n6282123060001        | Success Payload      | 201 \"Message sent successfully\" |\n6282123060002        | Bad Request          | 400 Validation error\" |\n6282123060003        | Invalid Header       | 401 \"Authorization failed\"  |\n6282123060004        | insufficient quota   | 403 \"Quota insufficient\" |\n6282123060005        | Blocked Msisdn       | 409 \"Msisdn invalid: msisdn has been blocked\" |\n6282123060006        | Too Many Request     | 429 \"Too many request in the allowed time frame\" |\n",
        "operationId": "send_whatsapp_msg_post_v2",
        "parameters": [
          {
            "required": true,
            "schema": {
              "title": "App-ID",
              "type": "string"
            },
            "name": "App-ID",
            "in": "header"
          },
          {
            "required": true,
            "schema": {
              "title": "API-Key",
              "type": "string"
            },
            "name": "API-Key",
            "in": "header"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendWhatsappMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseSendWhatsappMessage"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ValidationError": {
        "title": "ValidationError",
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          }
        }
      },
      "SendWhatsappMessage": {
        "title": "SendWhatsappMessage",
        "required": [
          "msisdn"
        ],
        "type": "object",
        "properties": {
          "msisdn": {
            "description": "Destination Phone Number. Scenario is the only valid msisdn to use. Any other  msisdn format will be marked as Invalid.",
            "type": "string",
            "example": "6282123060001"
          },
          "content": {
            "description": "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.",
            "type": "array",
            "items": {
              "type": "string",
              "example": "Verihubs"
            }
          },
          "lang_code": {
            "description": "Optional. Language code to send in a different language (need to be approved first too)",
            "type": "string",
            "example": "en"
          },
          "callback_url": {
            "description": "Optional. This URL will be called by the server when the desired event will occur.",
            "type": "string",
            "example": "https://your-url-callback.com"
          }
        }
      },
      "ResponseSendWhatsappMessage": {
        "title": "ResponseSendMessage",
        "required": [
          "message",
          "msisdn",
          "session_id"
        ],
        "type": "object",
        "properties": {
          "message": {
            "description": "Message",
            "type": "string",
            "example": "Message sent successfully"
          },
          "msisdn": {
            "description": "destination number with international prefix country code",
            "type": "string",
            "example": "6282123060001"
          },
          "session_id": {
            "description": "Generated ID which associated with verification request",
            "type": "string",
            "example": "asddede-asdae234-34sfd3-fe234d"
          }
        }
      }
    }
  }
}
````