Skip to main content
POST
Create Block Rules
Call Blocking – Blocked numbers will be rejected before reaching any agent. Blocking can apply globally or to specific inbound lines.

Headers

string
required
Your API key for authentication.

Body Parameters

string[]
required
A list of phone numbers to block, formatted in E.164 (e.g., +14155551234). Maximum 10 numbers per request.
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.
string
The E.164 formatted inbound number to associate the block with. Required when is_global is false.
string
Optional text to describe the reason for blocking.

Response

object
Contains the number of rules created and the list of created blocks.
number
Number of block rules successfully created.
array
List of block rule objects that were created.
null|array
null on success, or an array of error objects if validation fails.

Docs for agents: llms.txt