---
title: "Dodaj numery do czarnej listy"
method: POST
path: "/v1/blacklist"
tags: ["Czarna lista"]
---

# Dodaj numery do czarnej listy

`POST /v1/blacklist`

## Request

- Base URL: `https://api.przypominamy.com`
- URL: `https://api.przypominamy.com/v1/blacklist`
- Auth: HTTP bearer

Blokuje jeden numer (`msisdn`) lub wiele (`msisdns`, do 1000). Istniejący wpis jest nadpisywany (nowy powód i data wygaśnięcia). Nieprawidłowe numery wracają w `invalid` i nie przerywają żądania. Wysyłka na zablokowany numer dostaje status `rejected` bez opłaty. Wymaga zakresu `manage`.

## Request body

- object
  - `msisdn` string: Jeden numer (alternatywnie `msisdns`)
  - `msisdns` string[]: Lista numerów
  - `reason` string: Powód (domyślnie `manual`; link opt-out zapisuje `opt_out`)
  - `expires_at` string, date-time, nullable: Koniec blokady (ISO 8601, w przyszłości); brak = bezterminowo

## Response `201`

Dodano

- object
  - `added` integer: Liczba unikalnych, poprawnych numerów
  - `invalid` string[]: Odrzucone wartości
  - `expires_at` string, date-time, nullable

## Other responses

- `400`: Błąd walidacji
- `401`: Brak lub nieprawidłowy klucz API
- `403`: Klucz bez wymaganego zakresu (albo konto zawieszone / testowe wysyła na niezweryfikowany numer)

---

[API](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api.md) · [All operations](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/revisions/c20f9cfc2a7d?raw)