Update an Address

Update by ID

PUT https://api.moltin.com/v2/customers/:customerId/addresses/:addressId

Path Parameters

Name	Type	Description
customerId	string	The ID for the customer you are updating an address for

Headers

Name	Type	Description
X-Moltin-Customer-Token	string	A customer token used to access customer addresses implicitly
Authorization	string	The Bearer token to grant access to the API

Request Body

Name	Type	Description
id	string	The ID for the address you are updating
type	string	Represents the type of object being returned
first_name	string	The first name of the recipient on this address
last_name	string	The last name of the recipient on this address
name	string	The name under which this address is saved. You can display this name to the customer when you ask them to select from their saved addresses
phone_number	string	A phone number for this address
instructions	string	Any delivery instructions for this address
company_name	string	The company name at this address
line_1	string	The first portion of the address, usually the street address
line_2	string	The second portion of the address, usually an apartment or unit number
city	string	The city for this address
county	string	The county for this address
postcode	string	The ZIP Code, Postcode, or other postal reference string for this delivery address
country	string	A two digit code for the country this address is in, expressed as per the ISO 3166-2 standard

200

{
  "id": "5f8da740-6680-463e-b31c-190b2db4bf9d",
  "type": "address",
  "name": "Home",
  "first_name": "Ron",
  "last_name": "Swanson",
  "company_name": "",
  "phone_number": "[phone]",
  "line_1": "1 Sunny Street",
  "line_2": "Sunny Place",
  "city": "Sunny Town",
  "postcode": "SU33 1YY",
  "county": "Sunnyville",
  "country": "GB",
  "instructions": "Leave in the shed",
  "links": {
    "self":
      "https://api.moltin.com/v2/addresses/5f8da740-6680-463e-b31c-190b2db4bf9d"
  },
  "meta": {
    "timestamps": {
      "created_at": "2018-05-04T15:20:09.734Z",
      "updated_at": "2018-05-04T15:20:09.734Z"
    }
  }
}

cURL

curl -X POST https://api.moltin.com/v2/customers/:customerId/addresses \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
       "data": {
         "name": "Home",
         "first_name": "Ron",
         "last_name": "Swanson",
         "company_name": "",
         "phone_number": "[phone]",
         "line_1": "1 Sunny Street",
         "line_2": "Sunny Place",
         "city": "Sunny Town",
         "postcode": "SU33 1YY",
         "county": "Sunnyville",
         "country": "GB",
         "instructions": "Leave in the shed"
       }
     }'

JavaScript SDK

const MoltinGateway = require('@moltin/sdk').gateway

const Moltin = MoltinGateway({
  client_id: 'X',
  client_secret: 'X' // Required if customer token not present
})

const customer = 'XXXX'

const addressId = 'XXXX'

const address = {
  name: "Home sweet home",
}

const token = 'XXXX'

Moltin.Addresses.Update({
  customer,
  address: addressId,
  body: address,
  token // optional
}).then(address => {
  // Do something
})