---
title: "Create a blocked number"
method: POST
path: "/blocked-numbers"
tags: ["Blocked Numbers"]
---

# Create a blocked number

`POST /blocked-numbers`

Blocked numbers are phone numbers to which your account is not permitted to send messages.
The numbers can be created via this API, by a recipient replying with a STOP message to one
of your previous SENT messages, or by a BulkSMS administrator.

Sending a message to a blocked number will result in the message being assigned a status of
`FAILED.BLOCKED`. Messages sent to blocked numbers are billed to your account.

## Request body

- PhoneNumber[]

## Response `200`

Empty body upon success

---

[API](https://skmtc.dev/bulksms/apis/bulksms-json-rest-api.md) · [All operations](https://skmtc.dev/bulksms/apis/bulksms-json-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bulksms/bulksms-json-rest-api/revisions/f923d2ecca43/schema)