> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Block Rules

> Create one or more block rules to prevent specific phone numbers from reaching your inbound numbers.

> [!NOTE]
>
> **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.

```json Response theme={null}
{
  "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
}

```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.