Create Customer Address

POST 
/customers/:lookupKey/:lookupValue/addresses/

Use this endpoint to create an address for a customer. If the address is successfully created, the response will include the address id.

Fields

Name	Required
type	yes
code	no
firstName	no
middleName	no
lastName	no
gender	no Default is U
street	yes
number	no
numberExtension	no
postalCode	no
city	yes
country	yes
region	no
icp	no Default is N
phone	no
mobile	no
email	no
company	no
url	no
isDefault	no Default is N
notes	no

Request

Path Parameters

lookupKey stringrequired

Lookup key. Read more about customer lookup keys

lookupValue stringrequired

The value of the key (id or sourceId)

application/json

Body

city string
code string
country string
email string
firstName string
icp string
isDefault string
lastName string
middleName string
mobile string
notes string
number string
numberExtension string
phone string
postalCode string
region string
street string
type string
url string

Responses

201

Create Customer Address - 201

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• x-request-id

  string

application/json

Schema

Schema

data

object

city string

code string

country string

email string

firstName string

icp string

id number

isDefault string

lastName string

middleName string

mobile string

notes string

number string

numberExtension string

phone string

postalCode string

region string

street string

type string

url string
messages string[]
total number

Example (from schema)

{
  "data": {
    "city": "Arnhem",
    "code": "11234",
    "country": "NL",
    "email": "miles@propel.us",
    "firstName": "Miles",
    "icp": "N",
    "id": 106099,
    "isDefault": "Y",
    "lastName": "McCoy",
    "middleName": "",
    "mobile": "0038975648",
    "notes": "Address notes",
    "number": "34",
    "numberExtension": "A",
    "phone": "0032445888",
    "postalCode": "6822 DE",
    "region": "",
    "street": "Noordpad",
    "type": "delivery",
    "url": "www.propel.us"
  },
  "messages": [
    "Address created"
  ],
  "total": 1
}

Create Customer Address - 201

{
  "data": {
    "city": "Arnhem",
    "code": "11234",
    "country": "NL",
    "email": "miles@propel.us",
    "firstName": "Miles",
    "icp": "N",
    "id": 106099,
    "isDefault": "Y",
    "lastName": "McCoy",
    "middleName": "",
    "mobile": "0038975648",
    "notes": "Address notes",
    "number": "34",
    "numberExtension": "A",
    "phone": "0032445888",
    "postalCode": "6822 DE",
    "region": "",
    "street": "Noordpad",
    "type": "delivery",
    "url": "www.propel.us"
  },
  "messages": [
    "Address created"
  ],
  "total": 1
}

400

Create Customer Address - 400 (invalid schema)

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• x-request-id

  string

application/json

Schema

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 10007,
    "messages": [
      "#/isDefault: U is not a valid enum value"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/10007",
    "status": 400,
    "type": "SchemaValidationException"
  }
}

Create Customer Address - 400 (invalid schema)

{
  "error": {
    "code": 10007,
    "messages": [
      "#/isDefault: U is not a valid enum value"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/10007",
    "status": 400,
    "type": "SchemaValidationException"
  }
}

404

Create Customer Address - 404

Response Headers

• Alt-Svc

  string

• Via

  string

• alt-svc

  string

• content-length

  string

• date

  string

• return-format

  string

• x-request-id

  string

application/json

Schema

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 60007,
    "messages": [
      "Parent resource [Customer] with id [25496] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/60007",
    "status": 404,
    "type": "ParentCustomerNotFound"
  }
}

Create Customer Address - 404

{
  "error": {
    "code": 60007,
    "messages": [
      "Parent resource [Customer] with id [25496] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/60007",
    "status": 404,
    "type": "ParentCustomerNotFound"
  }
}

Loading...