POST
/
v1
/
blocked_numbers
Create Block Rules
curl --request POST \
  --url https://api.bland.ai/v1/blocked_numbers \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "numbers": [
    "<string>"
  ],
  "is_global": true,
  "inbound_number": "<string>",
  "reason": "<string>"
}'
{
  "data": {
    "created_count": 1,
    "blocks": [
      {
        "id": 123,
        "blocked_number": "+10000000000",
        "is_global": true,
        "inbound_number": null,
        "org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
        "reason": null,
        "is_active": true,
        "created_at": "2025-01-01T00:00:00.000Z",
        "updated_at": "2025-01-01T00:00:00.000Z"
      }
    ]
  },
  "errors": null
}
Call Blocking – Blocked numbers will be rejected before reaching any agent. Blocking can apply globally or to specific inbound lines.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
numbers
string[]
required
A list of phone numbers to block, formatted in E.164 (e.g., +14155551234). Maximum 10 numbers per request.
​
is_global
boolean
required
Set to true to block the numbers globally across all inbound numbers. Set to false to scope the block to a specific inbound_number. You cannot enable both is_global and inbound_number in the same request.
​
inbound_number
string
The E.164 formatted inbound number to associate the block with. Required when is_global is false.
​
reason
string
Optional text to describe the reason for blocking.

​
Response

​
data
object
Contains the number of rules created and the list of created blocks.
​
data.created_count
number
Number of block rules successfully created.
​
data.blocks
array
List of block rule objects that were created.
​
errors
null|array
null on success, or an array of error objects if validation fails.
{
  "data": {
    "created_count": 1,
    "blocks": [
      {
        "id": 123,
        "blocked_number": "+10000000000",
        "is_global": true,
        "inbound_number": null,
        "org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
        "reason": null,
        "is_active": true,
        "created_at": "2025-01-01T00:00:00.000Z",
        "updated_at": "2025-01-01T00:00:00.000Z"
      }
    ]
  },
  "errors": null
}