Request
Endpoint:
|
/api/number-addresses/new
|
Example:
|
/api/number-addresses/new
|
Method:
|
POST
|
Headers:
|
Accept: application/vnd.cloudlx.v1+json
|
Authorization: Bearer <access_token>
|
JSON Request
{
"name": "Epsilon UK Office",
"address_line_1": "Third Floor Telephone House",
"address_line_2": "69 Paul Street",
"address_city": "London",
"address_region": "London",
"address_postal_code": "EC2A 4NW",
"address_country": "GB",
"use_for_emergency_address": true,
}
JSON Parameters
name
|
Description
|
A friendly name for the address.
|
Type
|
String
|
Example
|
Epsilon UK Office
|
address_line_1
|
Description
|
First line of the address.
|
Type
|
String
|
Example
|
Third Floor Telephone House
|
address_city
|
Description
|
The city of the address.
|
Type
|
String
|
Example
|
London
|
address_region
|
Description
|
The region of the address or the state.
|
Type
|
String
|
Example
|
London
|
address_postal_code
|
Description
|
The postal code of the address.
|
Type
|
String
|
Example
|
EC2A 4NW
|
address_country
|
Description
|
The ISO-2 code for the country of the address.
|
Type
|
String
|
Example
|
GB
|
Optional JSON Parameters
address_line_2
|
Description
|
Second line of the address. This field is optional.
|
Type
|
String
|
Example
|
69 Paul Street
|
Default value
|
null
|
use_for_emergency_address*
|
Description
|
Whether to use this address as a Emergency Service registration Address.
|
Type
|
Boolean
|
Example
|
true
|
Default value
|
false
|
* At least one use_for_* parameter should be sent as true when creating a Number Address. More use_for_* parameters will be added to the API at a later date.
|
Response
Example:
{
"id": 2,
"message": "Address added successfully."
}
id
|
Description
|
The identifier of the number address.
|
Type
|
Integer
|
Example
|
2
|
message
|
Description
|
A message describing the result
|
Type
|
String
|
Example
|
Address added successfully.
|