---
title: "Create Address Endpoint"
method: POST
path: "/domains/{domain}/addresses/endpoints"
tags: ["Addresses"]
---

# Create Address Endpoint

`POST /domains/{domain}/addresses/endpoints`

## Path parameters

- `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.

## Request body

- object
  - `address-callback-number` union — This will match the callback number
    - string
    - integer
  - `address-name` string, required — This is the name label for the address
  - `caller-name` string, required — This is the caller's name for the address
  - `address-line-1` string — This is the address line 1 for the address
  - `address-line-2` string, nullable — This is the address line 2 for the address
  - `address-city` string — This is the city for the address
  - `address-state-province-abbreviation` string — This is the state or province (Canadian) abbreviation for the address
  - `address-postal-code` string — This is the postal code for the address
  - `address-country-abbreviation` string — This is the country appreviation for the address
  - `address-location-description` string, nullable — This is an optional location description for the address
  - `address-formatted-pidflo` object, nullable — This is a return value of the formatted PIDFLO standardized value for the address. For create/update either location-id or address-formatted-pidflo is needed. If address-formatted-pidflo is used, fill in address-line-1, address-city, etc for address information
  - `carrier` string, nullable — This is the carrier name for the address
  - `location-id` string, nullable — This is the address-id in cases for creation using an existing address. For create/update either location-id or address-formatted-pidflo is needed

## Response `202`

- object
  - `code` integer, required
  - `message` string, required

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/revisions/d37f65b5b886/schema)