blacklist

Add a number to the team blacklist

Changed on

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

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/blacklists/numbers
  • Auth
    API key in header Authorization

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.

Changes

    • info

      api operation id postBlacklistsNumbers was added

    • info

      the request property became nullable