---
title: "Create E911 address"
method: POST
path: "/api/relay/rest/addresses"
tags: ["E911 Addresses"]
---

# Create E911 address

`POST /api/relay/rest/addresses`

To create a new Address, make a POST request to the Address resource.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Request body

- CreateAddressRequest — Request body for creating an address.
  - `label` string, required — A friendly name given to the address to help distinguish and search for different addresses within your project.
  - `country` string, required — The ISO 3166 Alpha 2 country code.
  - `first_name` string, required — First name of the occupant associated with this address.
  - `last_name` string, required — Last name of the occupant associated with this address.
  - `street_number` string, required — The number portion of the street address.
  - `street_name` string, required — The name portion of the street address.
  - `address_type` 'Apartment' | 'Basement' | 'Building' | 'Department' | 'Floor' | 'Office' | 'Penthouse' | 'Suite' | 'Trailer' | 'Unit' — Address type for sub-addresses.
  - `address_number` string — If the address is divided into multiple sub-addresses, this identifies the particular sub-address.
  - `city` string, required — The city portion of the street address.
  - `state` string, required — The state/province/region of the street address. In the USA and Canada, use the two-letter abbreviated form.
  - `postal_code` string, required — The postal code of the street address.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- AddressResponse — Response containing a single address.
  - `id` string, uuid, required — Universal Unique Identifier.
  - `label` string, required — A friendly name given to the address to help distinguish and search for different addresses within your project.
  - `country` string, required — The ISO 3166 Alpha 2 country code.
  - `first_name` string, required — First name of the occupant associated with this address.
  - `last_name` string, required — Last name of the occupant associated with this address.
  - `street_number` string, required — The number portion of the street address.
  - `street_name` string, required — The name portion of the street address.
  - `address_type` 'Apartment' | 'Basement' | 'Building' | 'Department' | 'Floor' | 'Office' | 'Penthouse' | 'Suite' | 'Trailer' | 'Unit', required — Address type for sub-addresses.
  - `address_number` string, nullable, required — If the address is divided into multiple sub-addresses, this identifies the particular sub-address.
  - `city` string, required — The city portion of the street address.
  - `state` string, required — The state/province/region of the street address. In the USA and Canada, use the two-letter abbreviated form.
  - `postal_code` string, required — The postal code of the street address.
  - `zip_code` string, required — The postal code of the street address. Alias for postal_code for backwards compatibility.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/14b262a4830d?raw)