Skip to main content
PUT
/
api
/
v1
/
customers
/
{id}
.json
Update Customer
curl --request PUT \
  --url https://api.launchmystore.io/api/v1/customers/{id}.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "phone": "<string>",
  "accepts_marketing": true,
  "tags": [
    {}
  ],
  "note": "<string>",
  "tax_exempt": true,
  "addresses": [
    {
      "id": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "company": "<string>",
      "address1": "<string>",
      "address2": "<string>",
      "city": "<string>",
      "province": "<string>",
      "country": "<string>",
      "zip": "<string>",
      "phone": "<string>",
      "default": true
    }
  ]
}
'
{
  "success": true,
  "data": {}
}

​
Update Customer

Updates an existing customer’s information. Only include the fields you want to update.

​
Request

curl -X PUT "https://api.launchmystore.io/api/v1/customers/cust_abc123.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jonathan",
    "tags": ["VIP", "wholesale", "priority"],
    "note": "High-value customer, offer free shipping"
  }'

​
Path Parameters

​
id
string
required
The unique customer ID

​
Body Parameters

All body parameters are optional. Only include the fields you want to update.
​
email
string
Customer email address
​
first_name
string
Customer’s first name
​
last_name
string
Customer’s last name
​
phone
string
Customer’s phone number
​
accepts_marketing
boolean
Marketing opt-in status
​
tags
array
Array of tags (replaces existing tags)
​
note
string
Internal notes about the customer
​
tax_exempt
boolean
Whether customer is exempt from taxes
​
addresses
array
Array of addresses to add or update

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
The updated customer object

​
Example Response

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "email": "john.doe@example.com",
    "first_name": "Jonathan",
    "last_name": "Doe",
    "phone": "+1-555-123-4567",
    "verified_email": true,
    "accepts_marketing": true,
    "orders_count": 5,
    "total_spent": 25000,
    "tags": ["VIP", "wholesale", "priority"],
    "note": "High-value customer, offer free shipping",
    "tax_exempt": false,
    "addresses": [
      {
        "id": "addr_123",
        "address1": "123 Main St",
        "city": "New York",
        "province": "NY",
        "country": "US",
        "zip": "10001",
        "default": true
      }
    ],
    "created_at": "2023-06-15T10:30:00Z",
    "updated_at": "2024-01-25T16:00:00Z"
  }
}

​
Deleting Addresses

To delete an address, use the dedicated endpoint: 
curl -X DELETE "https://api.launchmystore.io/api/v1/customers/cust_abc123/addresses/addr_456.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have write_customers scope
NOT_FOUNDCustomer with the specified ID does not exist
VALIDATION_ERRORInvalid request body
DUPLICATE_EMAILEmail already in use by another customer