---
title: "Create address"
method: POST
path: "/v1/addresses"
tags: ["Regulatory"]
---

# Create address

`POST /v1/addresses`

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/addresses`
- Auth: HTTP bearer

Create a regulatory address, to use as the value of an `address` requirement when buying a phone number. It is registered for review when it is created, with status `pending`.

## Request body

- AddressCreateRequest: A regulatory address. `firstName` and `lastName` are required: the carrier will not register an address without a named person. Requests that omit them are refused with `400 invalid_request`, and the SDKs still type them as optional until their next release.
  - `firstName` string, required: First name of the person the address is registered to.
  - `lastName` string, required: Last name of the person the address is registered to.
  - `businessName` string: Business name, when the address belongs to a business. Defaults to the person's full name.
  - `streetAddress` string, required
  - `extendedAddress` string
  - `locality` string, required
  - `administrativeArea` string
  - `postalCode` string, required
  - `countryCode` string, required

## Response `201`

Address created.

- AddressResponse
  - `address` Address, required: A regulatory address for phone number requirements.
    - `id` string, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `businessName` string, nullable
    - `streetAddress` string, required
    - `extendedAddress` string, nullable
    - `locality` string, required
    - `administrativeArea` string, nullable
    - `postalCode` string, required
    - `countryCode` string, required
    - `status` 'pending' | 'verified' | 'rejected', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time

## Other responses

- `400`: Invalid request (first name and last name are required), or the address could not be registered for review.
- `401`: Unauthorized.

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)