---
title: "Create a new blacklist number"
method: POST
path: "/v1/senders/{id}/blockers"
tags: ["Senders"]
---

# Create a new blacklist number

`POST /v1/senders/{id}/blockers`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/senders/{id}/blockers`
- Auth: API key in header `X-Dexatel-Key`

## Request body

- BlacklistPostRequestWrapper
  - `data` object, required
    - `number` string: The end user's phone number as digits without spaces or special characters, beginning with the country dialing code

## Response `201`

OK

- BlacklistResponseWrapperDto
  - `data` BlacklistResponseDto
    - `id` string, uuid: Unique identifier of the blocked number
    - `sender_id` string, uuid: Unique identifier of the sender
    - `account_id` string, uuid: Unique identifier of the account
    - `number` string: The end user's phone number as digits without spaces or special characters, beginning with the country dialing code
    - `channel` string: Blocked number channel
    - `sender_name` string: Name (unique identifier) of the sender
    - `sender_code` string: User's company or brand name used as a sender identifier
    - `create_date` string, date-time: Creation date of the blocked number in UTC, formatted as yyyy-mm-dd hh:mm:ss

## Other responses

- `400`: **Bad Request:** Code Message Description 1438 'data.number' is required 1443 'data.number' is invalid
- `404`: **Not Found:** Code Message 1001 Sender \* not found

---

[API](https://skmtc.dev/dexatel/apis/contacts-and-messaging.md) - [All operations](https://skmtc.dev/dexatel/apis/contacts-and-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/contacts-and-messaging/revisions/f07e4f03a129?raw)