# Create address

> 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.

`POST https://api.zavu.dev/v1/addresses`

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`.

## Body

- `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)

## Responses

### 201

Address created.

- `address` (object, 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` (string, required) One of: `pending`, `verified`, `rejected`.
  - `createdAt` (string<date-time>, required)
  - `updatedAt` (string<date-time>)

### 400

Invalid request (first name and last name are required), or the address could not be registered for review.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

### 401

Unauthorized.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

## Example

```bash
curl -X POST "https://api.zavu.dev/v1/addresses" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "firstName": "John",
  "lastName": "Doe",
  "streetAddress": "123 Main St",
  "locality": "Berlin",
  "postalCode": "10115",
  "countryCode": "DE"
}'
```

```typescript
import Zavudev from "@zavudev/sdk";

const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY });

const result = await zavu.addresses.create({
  firstName: "John",
  lastName: "Doe",
  streetAddress: "123 Main St",
  locality: "Berlin",
  postalCode: "10115",
  countryCode: "DE",
});

console.log(result);
```