---
title: "Creates a user address"
method: POST
path: "/user/addresses"
tags: ["UserAddresses"]
---

# Creates a user address

`POST /user/addresses`

Creates a user address.

## Request body

- UserAddressCreate
  - `administrative_area` string — The locality of the user address. For US addresses, this corresponds to the state of the address.
  - `borough` string — The borough of the user address. This field is not used for addresses in the US but is used for some international addresses.
  - `business_name` string, required — The business name associated with the user address.
  - `country_code` string, required — The two-character (ISO 3166-1 alpha-2) country code of the user address.
  - `customer_reference` string — A customer reference string for customer look ups.
  - `extended_address` string — Additional street address information about the user address such as, but not limited to, unit number or apartment number.
  - `first_name` string, required — The first name associated with the user address.
  - `last_name` string, required — The last name associated with the user address.
  - `locality` string, required — The locality of the user address. For US addresses, this corresponds to the city of the address.
  - `neighborhood` string — The neighborhood of the user address. This field is not used for addresses in the US but is used for some international addresses.
  - `phone_number` string — The phone number associated with the user address.
  - `postal_code` string — The postal code of the user address.
  - `skip_address_verification` boolean — An optional boolean value specifying if verification of the address should be skipped or not. UserAddresses are generally used for shipping addresses, and failure to validate your shipping address will likely result in a failure to deliver SIM cards or other items ordered from Telnyx. Do not use this parameter unless you are sure that the address is correct even though it cannot be validated. If this is set to any value other than true, verification of the address will be attempted, and the user address will not be allowed if verification fails. If verification fails but suggested values are available that might make the address correct, they will be present in the response as well. If this value is set to true, then the verification will not be attempted. Defaults to false (verification will be performed).
  - `street_address` string, required — The primary street address information about the user address.

## Response `200`

Successful response

- object
  - `data` UserAddress
    - `administrative_area` string — The locality of the user address. For US addresses, this corresponds to the state of the address.
    - `borough` string — The borough of the user address. This field is not used for addresses in the US but is used for some international addresses.
    - `business_name` string — The business name associated with the user address.
    - `country_code` string — The two-character (ISO 3166-1 alpha-2) country code of the user address.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `customer_reference` string — A customer reference string for customer look ups.
    - `extended_address` string — Additional street address information about the user address such as, but not limited to, unit number or apartment number.
    - `first_name` string — The first name associated with the user address.
    - `id` string, uuid — Uniquely identifies the user address.
    - `last_name` string — The last name associated with the user address.
    - `locality` string — The locality of the user address. For US addresses, this corresponds to the city of the address.
    - `neighborhood` string — The neighborhood of the user address. This field is not used for addresses in the US but is used for some international addresses.
    - `phone_number` string — The phone number associated with the user address.
    - `postal_code` string — The postal code of the user address.
    - `record_type` string — Identifies the type of the resource.
    - `street_address` string — The primary street address information about the user address.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `422` — Bad request

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)