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

# Create address

`POST /v1/addresses`

Create a regulatory address for phone number purchases. Some countries require a verified address before phone numbers can be activated.

## Request body

- AddressCreateRequest
  - `firstName` string
  - `lastName` string
  - `businessName` string
  - `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.
- `401` — Unauthorized.

---

[API](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api.md) · [All operations](https://skmtc.net/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zavudev/zavu-unified-messaging-layer-api/revisions/5a69a1777f6f/schema)