Skip to Content
API ReferenceWhatsAppBlock / Unblock Users

Block / Unblock Users

Block a customer from sending you any further messages on a specific phone number (or unblock one you previously blocked). Mirrors the manual block-button in the WhatsApp Business app.

1. Block

POST /api/v25.0/{PHONE_NUMBER_ID}/block_users
Authorization: Bearer pk_live_<your-key>
Content-Type: application/json
{
  "messaging_product": "whatsapp",
  "block_users": [
    { "user": "+919999999999" },
    { "user": "+919888888888" }
  ]
}

Max 500 users per request. Submit larger batches in multiple calls.

Response — 200

{
  "messaging_product": "whatsapp",
  "block_users": {
    "added_users": [
      { "input": "+919999999999", "wa_id": "919999999999" },
      { "input": "+919888888888", "wa_id": "919888888888" }
    ],
    "errors": []
  }
}

If some entries fail (already blocked, invalid number), they appear in errors with a Meta-side code + message.

2. Unblock

DELETE /api/v25.0/{PHONE_NUMBER_ID}/block_users
Authorization: Bearer pk_live_<your-key>
Content-Type: application/json
{
  "messaging_product": "whatsapp",
  "block_users": [
    { "user": "+919999999999" }
  ]
}

Response — 200

{
  "messaging_product": "whatsapp",
  "block_users": {
    "removed_users": [
      { "input": "+919999999999", "wa_id": "919999999999" }
    ],
    "errors": []
  }
}

3. List currently blocked users

GET /api/v25.0/{PHONE_NUMBER_ID}/block_users?limit=100
Authorization: Bearer pk_live_<your-key>

Response — 200

{
  "data": [
    { "user": "919999999999", "block_reason": "manual" },
    { "user": "919888888888", "block_reason": "manual" }
  ],
  "paging": { "cursors": { "before": "...", "after": "..." } }
}

Effects of blocking

DirectionBehaviour
User → BusinessTheir messages are silently dropped at Meta’s edge. They see the message as sent on their side but you never receive a webhook
Business → UserOutbound /messages calls to a blocked user return (#131048) User is blocked
TemplatesMarketing templates to blocked users return the same 131048
QualityBlocking does not affect the phone-number quality rating

Errors

BodyWhen
(#131048) User is blockedOutbound send to a blocked user
(#100) Cannot block more than 500 users in one requestBatch too large
(#100) Invalid phone numberuser isn’t in E.164 format

cURL

# block
curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/block_users" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "block_users": [{ "user": "+919999999999" }]
  }'
 
# unblock
curl -X DELETE \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/block_users" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "block_users": [{ "user": "+919999999999" }]
  }'
GroupsMessage Analytics