---
title: "Create Blocked Phone Number"
method: POST
path: "/settings/blocked-phone-numbers"
tags: ["Settings"]
---

# Create Blocked Phone Number

`POST /settings/blocked-phone-numbers`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/settings/blocked-phone-numbers`
- Auth: none declared

Create a new blocked phone number.

What the block enforces (refused transfers, suppressed notifications) is
set by the customer's blocked caller settings.
Phone number must be in E.164 format (e.g., +12025551234).

## Request body

- BlockedPhoneNumberCreateRequest: Create blocked phone number request model
  - `phone_number` string, required: Phone number in E.164 format (e.g., +12025551234)
  - `name` string, required: Label for the blocked phone number

## Response `201`

Successful Response

- BlockedPhoneNumberResponse: Blocked phone number response model
  - `blocked_phone_number_id` string, uuid, required
  - `phone_number` string, required: Phone number in E.164 format
  - `name` string, required: Label for the blocked phone number

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)