---
title: "Create user phone number"
method: POST
path: "/resources/users/phone-numbers/v1"
tags: ["User Phone Numbers"]
---

# Create user phone number

`POST /resources/users/phone-numbers/v1`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/users/phone-numbers/v1`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/users/phone-numbers/v1/post.ts> (a function with typed inputs; its response is checked against the schema)

This route creates new user phone number. By default verification code will be sent to the user. To create phone number without verification code, send **`verify`** as part of the request with value **`false`**.

## Request body

- CreateUserPhoneNumberRequestDto
  - `phoneNumber` string, required: New phone number
  - `verify` boolean: Should send verification code, default is true

## Response `201`

- UserPhoneNumberCreatedResponseDto

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)