PUT/v1/tenants/{tenantId}/ecom_stores/{eComStoreId}/customers/{customerId}

Create or update customer

Idempotent endpoint - creates a new B2C customer with status RELEASED if it doesn't exist, otherwise updates the existing customer

Parameters

tenantIdpathstringnon-nullrequired
eComStoreIdpathstringnon-nullrequired
customerIdpathstringnon-nullrequired: The ID of the customer to create or update

Request body (optional)

Customer details. All fields are optional - only provided (non-null) fields will be updated.

application/jsonobjectnon-null

countryIsoCodestringnullableoptional

ISO 3166-1 alpha-2 country code

Example"NO"

electronicReceiptbooleannullableoptional

Whether the customer wants electronic receipts

Exampletrue

emailstringnullableoptional

Example"ola.nordmann@example.com"

firstNamestringnullableoptional

Example"Ola"

languageIsoCodestringnullableoptional

ISO 639-2 language code

Example"NOR"

lastNamestringnullableoptional

Example"Nordmann"

loyaltyProgramsarray of objectnullableoptional

Loyalty program enrollments to set for this customer

Show item fields

Loyalty program enrollment status for a customer

enrolledbooleannon-nullrequired: Whether the customer is enrolled in this loyalty program
Exampletrue
idstringnon-nullrequired: Unique identifier of the loyalty program
Example"01234567-89ab-cdef-0123-456789abcdef"
namestringnon-nullrequired: Example"Premium Members Club"

newsletterbooleannullableoptional

Whether the customer subscribes to the newsletter

Examplefalse

phonestringnullableoptional

Customer's phone number in E.164 format

Example"+4790123456"

View schema definition

Responses

200Response

application/jsonobjectnon-null

countryIsoCodestringnullableoptional

ISO 3166-1 alpha-2 country code

Example"NO"

customerNumberstringnullableoptional

Human-readable customer number

Example"CUST-10042"

deliveryAddressobjectnullableoptional

Customer's main delivery address

Show child fields

citystringnon-nullrequired: Example"Oslo"
countryIsoCodestringnon-nullrequired: ISO 3166-1 alpha-2 country code
Example"NO"
postCodestringnon-nullrequired: Example"0123"
streetstringnon-nullrequired: Street address including house number
Example"Storgata 1"

electronicReceiptbooleannon-nullrequired

Whether the customer wants electronic receipts

Exampletrue

emailstringnullableoptional

Example"ola.nordmann@example.com"

firstNamestringnullableoptional

Example"Ola"

idstringnon-nullrequired

Example"01234567-89ab-cdef-0123-456789abcdef"

invoiceAddressobjectnullableoptional

Customer's main invoice/billing address

Show child fields

citystringnon-nullrequired: Example"Oslo"
countryIsoCodestringnon-nullrequired: ISO 3166-1 alpha-2 country code
Example"NO"
postCodestringnon-nullrequired: Example"0123"
streetstringnon-nullrequired: Street address including house number
Example"Storgata 1"

languageIsoCodestringnullableoptional

ISO 639-2 language code

Example"NOR"

lastNamestringnullableoptional

Example"Nordmann"

loyaltyProgramCustomerIdstringnullableread-onlyoptional

Authoritative provider customer ID for this ecom store's configured loyalty program. Null if there is no configured program, no link, or the link is not ID-authoritative. Not proof of active membership. Read-only.

loyaltyProgramsarray of objectnon-nullrequired

List of loyalty programs and the customer's enrollment status

Show item fields

Loyalty program enrollment status for a customer

enrolledbooleannon-nullrequired: Whether the customer is enrolled in this loyalty program
Exampletrue
idstringnon-nullrequired: Unique identifier of the loyalty program
Example"01234567-89ab-cdef-0123-456789abcdef"
namestringnon-nullrequired: Example"Premium Members Club"

phonestringnullableoptional

Customer's phone number in E.164 format

Example"+4790123456"

View schema definition

400Bad Request - Invalid input data

Bad Request - Invalid input data

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

401Unauthorized - Invalid or missing authentication

Unauthorized - Invalid or missing authentication

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

403

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

409Conflict - Another customer already has this email (DUPLICATE_EMAIL) or phone number (DUPLICATE_PHONE)

Conflict - Another customer already has this email (DUPLICATE_EMAIL) or phone number (DUPLICATE_PHONE)

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

500

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition