/commercetools-customers | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
commercetools_customers_create_associate_roles | Creating a Associate Role generates the AssociateRoleCreated Message. |
commercetools_customers_create_business_units | POST /business-units |
commercetools_customers_create_business_units_search | If the initial indexing is in progress or the feature is inactive, A SearchNotReady error is returned. If inactive, you can reactivate it. |
commercetools_customers_create_customer_groups | POST /customer-groups |
commercetools_customers_create_customers | Allows converting an anonymous Cart to the active Cart of a Customer with cart merge. Creating a Customer produces the CustomerCreated Message. Simultaneously creating two Customers with the same email address can return a LockedField error. |
commercetools_customers_create_customers_email_confirm | Use this method to verify a global Customer’s email during their email verification process. Verifying the email of the Customer produces the CustomerEmailVerified Message. After the email is verified, all email tokens issued previously through the email verification flow are invalidated. This invalidation of tokens is eventually consistent. |
commercetools_customers_create_customers_email_token | Use this method to create an email token for a global Customer during their email verification process. Creating an email token for the Customer produces the CustomerEmailTokenCreated Message. The Message will include the token’s value, if the token’s validity is 60 minutes or less. |
commercetools_customers_create_customers_password | Changing the password produces the CustomerPasswordUpdated Message with reset=false. |
commercetools_customers_create_customers_password_reset | Use this method to reset a global Customer’s password during their password reset process. Resetting the password of the Customer produces the CustomerPasswordUpdated Message with reset=true. After the password is reset, all password tokens issued previously through the password reset flow are invalidated. In addition, any access and refresh tokens issued previously through the password flow and refresh token flow are invalidated. This invalidation of tokens is eventually consistent. |
commercetools_customers_create_customers_password_token | Use this method to create a password reset token for a global Customer during their password reset process. Creating a password reset token for the Customer produces the CustomerPasswordTokenCreated Message. The Message will include the token’s value, if the token’s validity is 60 minutes or less. |
commercetools_customers_create_customers_search | If the initial indexing is in progress or the feature is inactive, a SearchNotReady error is returned. If inactive, you can reactivate it. |
commercetools_customers_delete_associate_roles_by_id | DELETE /associate-roles/{ID} |
commercetools_customers_delete_associate_roles_by_key | Deleting an AssociateRole generates the AssociateRoleDeleted Message. An AssociateRole can only be deleted if it is not assigned to any Associates. |
commercetools_customers_delete_business_units_by_id | DELETE /business-units/{ID} |
commercetools_customers_delete_business_units_by_key | DELETE /business-units/key={key} |
commercetools_customers_delete_by_id | Deleting a Customer produces the CustomerDeleted Message. |
commercetools_customers_delete_by_key | Deleting a Customer produces the CustomerDeleted Message. |
commercetools_customers_delete_customer_groups_by_id | DELETE /customer-groups/{ID} |
commercetools_customers_delete_customer_groups_by_key | DELETE /customer-groups/key={key} |
commercetools_customers_get_associate_roles_by_id | GET /associate-roles/{ID} |
commercetools_customers_get_associate_roles_by_key | GET /associate-roles/key={key} |
commercetools_customers_get_business_units_associates_by_business_unit_id_and_associate_id | Retrieves roles and permissions of an Associate in a Business Unit. |
commercetools_customers_get_business_units_associates_by_key_and_associate_id | Retrieves roles and permissions of an Associate in a Business Unit. |
commercetools_customers_get_business_units_by_id | GET /business-units/{ID} |
commercetools_customers_get_business_units_by_key | GET /business-units/key={key} |
commercetools_customers_get_by_id | GET /customers/{ID} |
commercetools_customers_get_by_key | GET /customers/key={key} |
commercetools_customers_get_customer_groups_by_id | GET /customer-groups/{ID} |
commercetools_customers_get_customer_groups_by_key | GET /customer-groups/key={key} |
commercetools_customers_list_associate_roles | GET /associate-roles |
commercetools_customers_list_business_units | GET /business-units |
commercetools_customers_list_business_units_search_indexing_status | Returns the indexing status of the Business Unit Search for a Project. |
commercetools_customers_list_customer_groups | GET /customer-groups |
commercetools_customers_list_customers | GET /customers |
commercetools_customers_list_customers_email_token_email_token | Use this method to retrieve a global Customer’s details by using the email token during their email verification process. |
commercetools_customers_list_customers_password_token_password_token | Use this method to retrieve the details of a global Customer by using the password token during their password reset process. |
commercetools_customers_list_customers_search_indexing_status | Returns the indexing status of the Customer Search for a Project. |
commercetools_customers_update_associate_roles_by_id | POST /associate-roles/{ID} |
commercetools_customers_update_associate_roles_by_key | POST /associate-roles/key={key} |
commercetools_customers_update_business_units_by_id | POST /business-units/{ID} |
commercetools_customers_update_business_units_by_key | POST /business-units/key={key} |
commercetools_customers_update_customer_groups_by_id | POST /customer-groups/{ID} |
commercetools_customers_update_customer_groups_by_key | POST /customer-groups/key={key} |
commercetools_customers_update_customers_by_id | Simultaneously updating two Customers with the same email address can return a LockedField error. |
commercetools_customers_update_customers_by_key | Simultaneously updating two Customers with the same email address can return a LockedField error. |
commercetools_customers_create_associate_roles
Creating a Associate Role generates the AssociateRoleCreated Message. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
buyerAssignable | boolean | No | — | Buyer Assignable |
custom | object | No | — | The custom value |
key | string | Yes | — | The key value |
name | string | No | — | The name value |
permissions | string[] | No | — | The permissions value |
commercetools_customers_create_business_units
POST /business-units Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
addresses | object[] | No | — | The addresses value |
approvalRuleMode | string | No | — | Approval Rule Mode |
associateMode | string | No | — | Associate Mode |
associates | object[] | No | — | The associates value |
billingAddresses | integer[] | No | — | Billing Addresses |
contactEmail | string | No | — | Contact Email |
custom | object | No | — | The custom value |
customerGroupAssignments | object[] | No | — | Customer Group Assignments |
defaultBillingAddress | integer | No | — | Default Billing Address |
defaultShippingAddress | integer | No | — | Default Shipping Address |
key | string | Yes | — | The key value |
name | string | Yes | — | The name value |
shippingAddresses | integer[] | No | — | Shipping Addresses |
status | string | No | — | The status value |
storeMode | string | No | — | Store Mode |
stores | any[] | No | — | The stores value |
unitType | string | Yes | — | Unit Type |
commercetools_customers_create_business_units_search
If the initial indexing is in progress or the feature is inactive, A SearchNotReady error is returned. If inactive, you can reactivate it. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
query | object | No | — | Search query string |
sort | object[] | No | — | Sort order for results |
commercetools_customers_create_customer_groups
POST /customer-groups Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
custom | object | No | — | The custom value |
groupName | string | Yes | — | Group Name |
key | string | No | — | The key value |
commercetools_customers_create_customers
Allows converting an anonymous Cart to the active Cart of a Customer with cart merge. Creating a Customer produces the CustomerCreated Message. Simultaneously creating two Customers with the same email address can return a LockedField error. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
addresses | object[] | No | — | The addresses value |
anonymousCart | object | No | — | Anonymous Cart |
anonymousCartId | string | No | — | Anonymous Cart Id |
anonymousId | string | No | — | Anonymous Id |
authenticationMode | string | No | — | Authentication Mode |
billingAddresses | integer[] | No | — | Billing Addresses |
companyName | string | No | — | Company Name |
custom | object | No | — | The custom value |
customerGroup | object | No | — | Customer Group |
customerGroupAssignments | object[] | No | — | Customer Group Assignments |
customerNumber | string | No | — | Customer Number |
dateOfBirth | string | No | — | Date Of Birth |
defaultBillingAddress | integer | No | — | Default Billing Address |
defaultShippingAddress | integer | No | — | Default Shipping Address |
email | string | Yes | — | The email value |
externalId | string | No | — | External Id |
firstName | string | No | — | First Name |
isEmailVerified | boolean | No | — | Is Email Verified |
key | string | No | — | The key value |
lastName | string | No | — | Last Name |
locale | string | No | — | Locale or language code |
middleName | string | No | — | Middle Name |
password | string | No | — | The password value |
salutation | string | No | — | The salutation value |
shippingAddresses | integer[] | No | — | Shipping Addresses |
stores | any[] | No | — | The stores value |
title | string | No | — | The title value |
vatId | string | No | — | Vat Id |
commercetools_customers_create_customers_email_confirm
Use this method to verify a global Customer’s email during their email verification process. Verifying the email of the Customer produces the CustomerEmailVerified Message. After the email is verified, all email tokens issued previously through the email verification flow are invalidated. This invalidation of tokens is eventually consistent. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tokenValue | string | Yes | — | Token Value |
version | integer | No | — | The version value |
commercetools_customers_create_customers_email_token
Use this method to create an email token for a global Customer during their email verification process. Creating an email token for the Customer produces the CustomerEmailTokenCreated Message. The Message will include the token’s value, if the token’s validity is 60 minutes or less. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The id value |
invalidateOlderTokens | boolean | No | — | Invalidate Older Tokens |
ttlMinutes | integer | Yes | — | Ttl Minutes |
version | integer | No | — | The version value |
commercetools_customers_create_customers_password
Changing the password produces the CustomerPasswordUpdated Message withreset=false.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
currentPassword | string | Yes | — | Current Password |
id | string | Yes | — | The id value |
newPassword | string | Yes | — | New Password |
version | integer | Yes | — | The version value |
commercetools_customers_create_customers_password_reset
Use this method to reset a global Customer’s password during their password reset process. Resetting the password of the Customer produces the CustomerPasswordUpdated Message withreset=true. After the password is reset, all password tokens issued previously through the password reset flow are invalidated. In addition, any access and refresh tokens issued previously through the password flow and refresh token flow are invalidated. This invalidation of tokens is eventually consistent.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
newPassword | string | Yes | — | New Password |
tokenValue | string | Yes | — | Token Value |
version | integer | No | — | The version value |
commercetools_customers_create_customers_password_token
Use this method to create a password reset token for a global Customer during their password reset process. Creating a password reset token for the Customer produces the CustomerPasswordTokenCreated Message. The Message will include the token’s value, if the token’s validity is 60 minutes or less. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | string | Yes | — | The email value |
invalidateOlderTokens | boolean | No | — | Invalidate Older Tokens |
ttlMinutes | integer | No | — | Ttl Minutes |
commercetools_customers_create_customers_search
If the initial indexing is in progress or the feature is inactive, a SearchNotReady error is returned. If inactive, you can reactivate it. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
query | object | No | — | Search query string |
sort | object[] | No | — | Sort order for results |
commercetools_customers_delete_associate_roles_by_id
DELETE /associate-roles/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_associate_roles_by_key
Deleting an AssociateRole generates the AssociateRoleDeleted Message. An AssociateRole can only be deleted if it is not assigned to any Associates. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_business_units_by_id
DELETE /business-units/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_business_units_by_key
DELETE /business-units/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_by_id
Deleting a Customer produces the CustomerDeleted Message. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
dataErasure | boolean | No | — | Data Erasure |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_by_key
Deleting a Customer produces the CustomerDeleted Message. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
dataErasure | boolean | No | — | Data Erasure |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_customer_groups_by_id
DELETE /customer-groups/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_delete_customer_groups_by_key
DELETE /customer-groups/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
version | integer | Yes | — | The version value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_associate_roles_by_id
GET /associate-roles/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_associate_roles_by_key
GET /associate-roles/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_business_units_associates_by_business_unit_id_and_associate_id
Retrieves roles and permissions of an Associate in a Business Unit. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
businessUnitId | string | Yes | — | Business Unit Id |
associateId | string | Yes | — | Associate Id |
commercetools_customers_get_business_units_associates_by_key_and_associate_id
Retrieves roles and permissions of an Associate in a Business Unit. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
associateId | string | Yes | — | Associate Id |
commercetools_customers_get_business_units_by_id
GET /business-units/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_business_units_by_key
GET /business-units/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_by_id
GET /customers/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_by_key
GET /customers/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_customer_groups_by_id
GET /customer-groups/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_get_customer_groups_by_key
GET /customer-groups/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_list_associate_roles
GET /associate-roles Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
sort | string[] | No | — | Sort order for results |
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
withTotal | boolean | No | — | With Total |
where | string[] | No | — | The where value |
commercetools_customers_list_business_units
GET /business-units Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
sort | string[] | No | — | Sort order for results |
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
withTotal | boolean | No | — | With Total |
where | string[] | No | — | The where value |
commercetools_customers_list_business_units_search_indexing_status
Returns the indexing status of the Business Unit Search for a Project.commercetools_customers_list_customer_groups
GET /customer-groups Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
where | string[] | No | — | The where value |
expand | string[] | No | — | Related resources to expand inline |
sort | string[] | No | — | Sort order for results |
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
withTotal | boolean | No | — | With Total |
commercetools_customers_list_customers
GET /customers Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
expand | string[] | No | — | Related resources to expand inline |
sort | string[] | No | — | Sort order for results |
limit | integer | No | — | Maximum number of results to return |
offset | integer | No | — | The offset value |
withTotal | boolean | No | — | With Total |
where | string[] | No | — | The where value |
commercetools_customers_list_customers_email_token_email_token
Use this method to retrieve a global Customer’s details by using the email token during their email verification process. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emailToken | string | Yes | — | Email Token |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_list_customers_password_token_password_token
Use this method to retrieve the details of a global Customer by using the password token during their password reset process. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
passwordToken | string | Yes | — | Password Token |
expand | string[] | No | — | Related resources to expand inline |
commercetools_customers_list_customers_search_indexing_status
Returns the indexing status of the Customer Search for a Project.commercetools_customers_update_associate_roles_by_id
POST /associate-roles/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_associate_roles_by_key
POST /associate-roles/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_business_units_by_id
POST /business-units/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_business_units_by_key
POST /business-units/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_customer_groups_by_id
POST /customer-groups/{ID} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_customer_groups_by_key
POST /customer-groups/key={key} Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_customers_by_id
Simultaneously updating two Customers with the same email address can return a LockedField error. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ID | string | Yes | — | The id value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |
commercetools_customers_update_customers_by_key
Simultaneously updating two Customers with the same email address can return a LockedField error. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | Yes | — | The key value |
expand | string[] | No | — | Related resources to expand inline |
actions | object[] | Yes | — | The actions value |
version | integer | Yes | — | The version value |

