---
title: "Add a number to a user's blacklist"
method: POST
path: "/users/{userId}/blacklists/numbers"
tags: ["blacklist"]
---

# Add a number to a user's blacklist

`POST /users/{userId}/blacklists/numbers`

Adds a phone number to a user's personal blacklist. Once blacklisted, calls from this number to the user are blocked. An optional comment can be attached to explain why the number was blocked (e.g., "spam caller", "wrong number"). If the number is already blacklisted, the request returns `304 Not Modified`.

**Permission:** `Users Write` required.

**Monitoring impact:**
- **OFF:** Can only add to **your own** blacklist.
- **ON:** Can add to **any user's** blacklist.

## Path parameters

- `userId` integer, required

## 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

## Other responses

- `304` — The number is already in this user's blacklist
- `400` — The provided user ID or request body is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Write permission is missing
- `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)