---
title: "Block Number"
method: POST
path: "/v1/whatsapp/blocked-numbers"
tags: ["Blocked Numbers"]
---

# Block Number

`POST /v1/whatsapp/blocked-numbers`

## Request

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

**⚠️ This endpoint will be deprecated on June 30, 2026.**

This method helps you to block phone numbers to not be able to receive message from WhatsApp OTP & Message services

## Headers

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

## Request body

- PostBlockedNumber
  - `msisdn` string, required: Destination Phone Number. You need to include international prefix number.
  - `description` string, required: Describe reason for blocking specific phone number.

## Response `200`

Successful Response

- ResponsePostBlockedNumber
  - `code` integer, required: Code **(to be deleted on November 30, 2022)**
  - `message` string, required: Message

## Other responses

- `400`: Bad Request
- `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)