Skip to main content

​
Overview

This endpoint can be used to create a new address. Endpoint: /api/v1/addresses Method: POST
It is critically important that you verify the address before creating it.Failure to verify the address may result in loss or delayed shipments.You may also be charged should address correction be necessary by the carrier.

​
Request

​
string
required
For example, “John Smith” or “Acme Products”.Minimum character length: 2Maximum character length: 50
​
string
required
The contact email address.Carriers may send one or more shipment tracking notifications to this email address.Minimum character length: 6Maximum character length: 100
​
string
required
The contact phone number.This must be formatted using the E.164 standard.Minimum character length: 7Maximum character length: 30
​
string
required
Line 1 of the address.Minimum character length: 2Maximum character length: 35
​
string
Line 2 of the address.Minimum character length: 2Maximum character length: 35
​
string
required
The address’ town or city.Minimum character length: 2Maximum character length: 35
​
string
required
The address’ state, province, or region.Minimum character length: 2Maximum character length: 30
​
string
required
The address’ post code.Minimum character length: 2Maximum character length: 16
​
integer
required
A Country enum representing the address’ country.

​
Response

If the address is successfully created, the API will return a 201 Created status code. The response will contain the following content:
​
integer
required
The ID of the newly created address.