Download OpenAPI specification:Download
Create, manage, and delete customer profiles.
Note: This part of the Customer Service is managed by the customers on the storefront.
Key Features:
Key Benefits:
Adds an address to a customer's profile.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
Created
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "contactName": "John Doe",
- "companyName": "Emporix",
- "street": "Platz der Republik",
- "streetNumber": "1",
- "streetAppendix": "",
- "extraLine1": "",
- "extraLine2": "",
- "extraLine3": "",
- "extraLine4": "",
- "zipCode": "11011",
- "city": "Berlin",
- "country": "DE",
- "state": "Berlin",
- "contactPhone": "123456789",
- "tags": [
- "BILLING",
- "SHIPPING"
]
}
{- "id": "b05c20e034"
}
Retrieves a list of addresses for a customer.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
[- {
- "contactName": "John Doe",
- "companyName": "Emporix",
- "street": "Platz der Republik",
- "streetNumber": "1",
- "streetAppendix": "",
- "extraLine1": "",
- "extraLine2": "",
- "extraLine3": "",
- "extraLine4": "",
- "zipCode": "11011",
- "city": "Berlin",
- "country": "DE",
- "state": "Berlin",
- "contactPhone": "123456789",
- "tags": [
- "BILLING",
- "SHIPPING"
], - "id": "b05c20e034",
- "isDefault": true
}
]
Updates a specified customer address.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
Address with the specified addressId
doesn't exist.
{- "contactName": "John Doe",
- "companyName": "Emporix",
- "street": "Platz der Republik",
- "streetNumber": "1",
- "streetAppendix": "",
- "extraLine1": "",
- "extraLine2": "",
- "extraLine3": "",
- "extraLine4": "",
- "zipCode": "11011",
- "city": "Berlin",
- "country": "DE",
- "state": "Berlin",
- "contactPhone": "123456789",
- "tags": [
- "BILLING",
- "SHIPPING"
], - "isDefault": true
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Retrieves a specified customer address and its details.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
Address with the specified addressId
doesn't exist.
{- "contactName": "John Doe",
- "companyName": "Emporix",
- "street": "Platz der Republik",
- "streetNumber": "1",
- "streetAppendix": "",
- "extraLine1": "",
- "extraLine2": "",
- "extraLine3": "",
- "extraLine4": "",
- "zipCode": "11011",
- "city": "Berlin",
- "country": "DE",
- "state": "Berlin",
- "contactPhone": "123456789",
- "tags": [
- "BILLING",
- "SHIPPING"
], - "id": "b05c20e034",
- "isDefault": true
}
Deletes a specified customer address and accounts associated with it.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
Address with the specified addressId
doesn't exist.
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Updates a customer's profile.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "title": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "contactEmail": "example@customer.com",
- "contactPhone": "123456789",
- "company": "Emporix",
- "preferredLanguage": "en_US",
- "preferredCurrency": "EUR",
- "preferredSite": "main",
- "b2b": {
- "companyRegistrationId": "123-456-789"
}, - "metadata": {
- "version": 1
}
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Retrieves a customer's profile.
Note: The request needs to be authorized with a customer's access token or an anonymous access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "title": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "contactPhone": "123456789",
- "company": "Emporix",
- "preferredLanguage": "en_US",
- "preferredCurrency": "USD",
- "preferredSite": "default",
- "metadata": {
- "mixins": { },
- "version": 2
}, - "mixins": { },
- "customerNumber": "13869000",
- "id": "13869000",
- "accounts": [
- {
- "id": "example@customer.com"
}
], - "contactEmail": "example@customer.com",
- "businessModel": "B2B",
- "b2b": {
- "companyRegistrationId": "123-456-789",
- "legalEntities": [
- {
- "id": "D165356",
- "name": "BMW",
- "contactAssignmentId": "D436432"
}
]
}
}
Deletes a customer's profile and the account associated with it.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
Customer profile deletion confirmation was successfully accepted
Customer profile deletion request was successful
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Assigns a customer account to the customer's profile.
customer.customer_update
or customer.customer_manage
Created
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "email": "john.doe@example.com",
- "password": "password123"
}
{- "id": "13869000"
}
Creates a new customer account.
Note: The request needs to be authorized with an anonymous access token.
No specific scopes are required.
Created
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "email": "example@customer.com",
- "password": "password123",
- "customerDetails": {
- "title": "MR",
- "firstName": "John",
- "middleName": "",
- "lastName": "Doe",
- "contactEmail": "example@customer.com",
- "contactPhone": "123456789",
- "company": "Emporix",
- "preferredLanguage": "en_US",
- "preferredCurrency": "EUR",
- "preferredSite": "main",
- "b2b": {
- "companyRegistrationId": "123-456-789"
}
}, - "customerAddress": {
- "contactName": "John Doe",
- "companyName": "Emporix",
- "street": "Platz der Republik",
- "streetNumber": "1",
- "streetAppendix": "",
- "extraLine1": "",
- "extraLine2": "",
- "extraLine3": "",
- "extraLine4": "",
- "zipCode": "11011",
- "city": "Berlin",
- "country": "DE",
- "state": "Berlin",
- "contactPhone": "123456789",
- "tags": [
- "BILLING",
- "SHIPPING"
]
}
}
{- "id": "13730481"
}
Logs in a customer and sends an authentication request and retrieves a customer token.
Note: The request needs to be authorized with an anonymous access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "email": "example@customer.com",
- "password": "password123"
}
{- "accessToken": "aYR3Lu3rpsQ9ODhBIR83b3txTr5K",
- "saasToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMzg2OTAwMCIsImV4cCI6MTY0MDQ0NDAzMn0.lvxFOeCOk-DWi3kqwJwR8eKal3ON2rr53e9I6Pha5rI",
- "expiresIn": 2591999,
- "refreshToken": "94tKQ2Tsvlf9dYbmyccA7X1Rqe54B6dH",
- "refreshTokenExpiresIn": 86399
}
Logs out a customer and invalidates their customer token.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Refreshes a customer's access token.
Note: The request needs to be authorized with an anonymous access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "accessToken": "2yXy8H7sByl4JSWrr7GRqxiCRMUm",
- "expiresIn": 2591999,
- "refreshToken": "iwXAFjGwboaehJar1qNOkV05phDw1god",
- "refreshTokenExpiresIn": 86390
}
Logs in a customer using an authentication code from Auth0 and retrieves a standard customer token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "email": "example@customer.com",
- "name": "John Doe",
- "provider": "string"
}
{- "customerNumber": "string"
}
Creates a customer account using the token obtained through double opt-in.
Note: The request needs to be authorized with an anonymous access token.
No specific scopes are required.
OK
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "accessToken": "HzcnecB5l6STzXhRqU0Zp6hxS0Ay",
- "saasToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI4NzQxMzI1MCIsImV4cCI6MTYzMjA1NDEzN30.p6g_G5ZbhjlvnObVC2OWGslLWWktxBw8onionfFvm4c",
- "expiresIn": 2591999,
- "refreshToken": "tMhLYc8pfAqb1g10Z1o7BxABArxXe3db",
- "refreshTokenExpiresIn": 86399
}
Resends an account activation link to the customer.
Note: The request needs to be authorized with an anonymous access token.
No specific scopes are required.
Accepted
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
{- "email": "example@customer.com"
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Sends a request to change a customer's email address. As a result, the customer receives a unique token through email.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
Request for changing login email token using current email id and password.
Requires scope customer.customerprofile_edit
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "email": "example@customer.com",
- "password": "password123",
- "newEmail": "example@emporix.com",
- "syncContactEmail": true
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Updates a customer's email address using the token received through email.
Note: The request needs to be authorized with a anonymous access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "token": "beExUmshJC5gnuXk1kET5dCLyQWkrAfKRGFOxVXLcJI13R1fn5USjaWku5G71whM"
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Sends a request to reset a Customer's account password. As a result, the customer receives a unique token through email.
Note: The request needs to be authorized with a anonymous access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "email": "example@customer.com"
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Resets a customer's password using the token received through email and sets a new password.
Note: The request needs to be authorized with a anonymous access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "token": "beExUmshJC5gnuXk1kET5dCLyQWkrAfKRGFOxVXLcJI13R1fn5USjaWku5G71whM",
- "password": "P@ssw0rd123"
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}
Changes a Customer's account password.
Note: The request needs to be authorized with a customer's access token.
No specific scopes are required.
No Content
Request was syntactically incorrect. Details will be provided in the response payload.
Unauthorized
Given authorization scopes are not sufficient and do not match scopes required by the endpoint.
{- "currentPassword": "password123",
- "newPassword": "P@ssw0rd123"
}
{- "type": "bad_request",
- "status": 400,
- "message": "The tenant information provided with the request is not valid."
}