---
title: "Add a number to the team blacklist"
method: POST
path: "/blacklists/numbers"
tags: ["blacklist"]
---

# Add a number to the team blacklist

`POST /blacklists/numbers`

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.

## Request body

- RequestNewBlacklist
  - `number` integer — Phone number (E.164 format) (mandatory)
  - `comment` string, nullable — A comment about this blacklisted number
  - `direction` string — IN (default value) or OUT for blacklisted numbers

## Response `200`

Successful operation — number added to blacklist.

## Other responses

- `304` — Number already blacklisted (not modified).
- `401` — Unauthorized — invalid or missing API token, missing `Numbers Write` permission, or Monitoring is OFF.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)