---
title: "Create a Blocked Phone Number"
method: POST
path: "/blocked_phone_number/"
tags: ["blocked_phone_numbers"]
---

# Create a Blocked Phone Number

`POST /blocked_phone_number/`

Once this record is created, the phone number you have specified will no longer work for outbound nor inbound calls. That means:

* Nobody in your organization will be able to call that phone number.
* That phone number will not be able to call anybody in your organization.

## Request body

- CreateBlockedPhoneNumber
  - `phone` string, required — The phone number (in E.164 format) that you wish to block.
  - `reason` string, required — The reason why you wish to block a given phone number.

## Response `201`

Successful response

- BlockedPhoneNumber
  - `created_by` string, required — User who created this Blocked Number initially.
  - `date_created` string, date-time, required — When this Blocked Number was created.
  - `date_updated` string, date-time, required — When this Blocked Number was last updated.
  - `id` string, required
  - `organization_id` string, required
  - `phone` string, required — The phone number (in E.164 format) to block.
  - `reason` string, required — The reason for blocking the given phone number.
  - `updated_by` string, required — User who most recently updated this Blocked Number.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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