Skip to main content
PATCH
Update a customer

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

id
integer
required

Customer's Id

Body

application/json

Request payload

first_name

First name of customer

last_name

Last name of customer

email

Email of customer

phone

Phone number of customer

account_id

A unique Account Id for customer. If empty, one is generated by the system

external_id

A unique External Id for customer that is used to identify them in external systems. Deprecated for new integrations: this v0 endpoint is superseded by PATCH /api/v2025-06/members/{member_id} (operationId admin_v2025_06_members_patch), which accepts the same external_id and is the actively-developed lane for member external IDs. The field and this endpoint remain fully supported for existing integrations; nothing about their behaviour changes.

notes

Note for customer

metadata
object | null

A JSON object that can store any custom data structure. When provided, replaces all existing metadata data.

default_address_attributes
object | null
customer_notes_attributes
(object | null)[] | null
metafields_attributes
(object | null)[] | null

Metafields for custom data storage

Response

string | number | boolean | null | any[] | object

Success

Any valid JSON value for provider, integration, theme, metadata, or other dynamic payloads whose keys are not fixed by the API contract.