latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

blacklist

Add a number to the team blacklist

Adds a phone number to your team's shared blacklist. Once added, calls from this number are blocked for all users in the team. An optional comment can explain the reason (e.g., "spam", "harassment"). If the number is already blacklisted, the request returns 304 Not Modified.

Permission: Numbers Write required.

Monitoring: Required. Team blacklist management is a supervisory feature. Returns 401 Unauthorized if Monitoring is OFF on your API key.

post/blacklists/numbers

Request body

numberinteger

Phone number (E.164 format) (mandatory)

commentstring nullable

A comment about this blacklisted number

directionstring

IN (default value) or OUT for blacklisted numbers

Example request

{
  "number": 33184800000,
  "direction": "IN"
}

Response

Successful operation — number added to blacklist.