Create a billing address

Creates a new billing address.

POST/v3/billing/addresses
JWT
paymentMethod:write

Request Body Schema

PropertyTypeDescriptionConstraints
firstLine*stringmin: 1, max: 256
secondLinestringmin: 0, max: 256
city*stringmin: 1, max: 256
postalCode*stringmin: 1, max: 256
region*stringmin: 1, max: 256
countryCode*stringmin: 1, max: 256
name*stringmin: 1, max: 256
taxIdentifierstringmin: 0, max: 256
contacts*arrayitems: object
namestring
email*string

Request Example

{
  "firstLine": "string",
  "secondLine": "string",
  "city": "string",
  "postalCode": "string",
  "region": "string",
  "countryCode": "string",
  "name": "string",
  "taxIdentifier": "string",
  "contacts": [
    {
      "name": "string",
      "email": "string"
    }
  ]
}
Triggers webhook: billingAddress.created
POST <your-webhook-url>
{
  "event": "billingAddress.created",
  "data": {
    "id": "string",
    "firstLine": "string",
    "secondLine": "string",
    "city": "string",
    "postalCode": "string",
    "region": "string",
    "countryCode": "string",
    "name": "string",
    "taxIdentifier": "string",
    "contacts": [
      {
        "name": "string",
        "email": "string"
      }
    ],
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "triggeredAt": "string"
}

Responses

200 OK
{
  "id": "string",
  "firstLine": "string",
  "secondLine": "string",
  "city": "string",
  "postalCode": "string",
  "region": "string",
  "countryCode": "string",
  "name": "string",
  "taxIdentifier": "string",
  "contacts": [
    {
      "name": "string",
      "email": "string"
    }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}