---
title: "Block User"
method: POST
path: "/wa/app/{appId}/user/block"
---

# Block User

`POST /wa/app/{appId}/user/block`

## Request

- Base URL: `https://api.gupshup.io`
- URL: `https://api.gupshup.io/wa/app/{appId}/user/block`
- Auth: none declared. Required headers: `apikey`

API to block user

Notes:
- You can only block users that have messaged your business in the last 24 hours.
- 64k blocklist limit

## Path parameters

- `appId` string, required

## Headers

- `apikey` string, required

## Request body

- object
  - `messaging_product` 'whatsapp', required: Must be "whatsapp"
  - `block_users` object[], required: List of users that need to be blocked
    - `user` string, required: Phone number of the user to block

## Response `200`

Successful operation

- object
  - `block_users` object
    - `added_users` object[]
      - `input` string: Phone number of a WhatsApp user
      - `wa_id` string: Unique ID of a WhatsApp user
  - `messaging_product` string
  - `status` string

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/gupshup/apis/block-user.md) - [All operations](https://skmtc.dev/gupshup/apis/block-user/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/block-user/revisions/6b11971320d9?raw)