commerce/customer/accounts

Use the Customer Accounts resource to manage the components of shopper accounts, including attributes, contact information, company notes, and groups associated with the customer account.

JSON Example

CustomerAccount Properties

Property Description
acceptsMarketing

type: bool

Indicates if the customer account is opted to receive marketing materials. If true, the customer account is opted in for receiving the content.

attributes

type: list of customerAttribute

Collection of attributes that may be paged list or a list, depending on the usage per object and API type.

customerAttribute.attributeDefinitionId

type: int

Unique identifier of the attribute definition.

customerAttribute.fullyQualifiedName

type: string

Fully qualified name of the attribute for the order or customer.

customerAttribute.values

type: list of object

List of value data for objects.

companyOrOrganization

type: string

The entered company or organization name entered for a customer account.

customerSet

type: string

The details of the customer set.

customerSinceDate

type: DateTime

This property tracks the customer account creation date. This date can be set manually via the API for customer accounts that are imported into Kibo eCommerce.

emailAddress

type: string

The email address for the customer account and contact. This email may be used for login to the storefront and for subscription mailing lists.

externalId

type: string

Unique identifier used by an external program to identify a Kibo eCommerce order, customer account, or wish list.

firstName

type: string

The full first name of a customer or contact name.

hasExternalPassword

type: bool

Indicates if an external password is set on this account.

isActive

type: bool

Indicates if the object or feature is active.

isAnonymous

type: bool

If true, this customer account represents an anonymous shopper.

isLocked

type: bool

Indicates if a customer account and associated data is locked. If true, the user account is locked due to multiple failed authentication attempts. The user cannot login until the account is unlocked.

lastName

type: string

The full last name of a customer or contact name.

localeCode

type: string

The two character locale code, per the country code provided. This code determines the localized content to use and display.

taxExempt

type: bool

If true, this customer account has tax exempt status.

taxId

type: string

The tax identification number associated with the customer account.

userName

type: string

The user name associated with the user profile. The customer uses the user name to access the account.

Operations

Operation Name Request URI Description
AddAccount POST %3fresponseFields%3d%7bresponseFields%7d

Creates a new customer account based on the information specified in the request.

AddAccountAndLogin POST Add-Account-And-Login%3fresponseFields%3d%7bresponseFields%7d

Creates a new customer account and logs the user associated with the customer account into the site.

AddAccounts POST Bulk%3fresponseFields%3d%7bresponseFields%7d

Creates multiple customer accounts based on the information specified in the request.

AddLoginToExistingCustomer POST %7baccountId%7d%2fCreate-Login%3fresponseFields%3d%7bresponseFields%7d

Adds a new user login to a defined customer account.

ChangePassword POST %7baccountId%7d%2fChange-Password%3funlockAccount%3d%7bunlockAccount%7d

Modifies the password associated with a customer account.

ChangePasswords POST Change-Passwords%3fresponseFields%3d%7bresponseFields%7d

Changes a collection of customer account passwords.

DeleteAccount DELETE %7baccountId%7d

Deletes a customer account. A customer account cannot be deleted if any orders exist, past or present.

GetAccount GET %7baccountId%7d%3fresponseFields%3d%7bresponseFields%7d

Retrieve details of a customer account.

GetAccounts GET %3fstartIndex%3d%7bstartIndex%7d%26pageSize%3d%7bpageSize%7d%26sortBy%3d%7bsortBy%7d%26filter%3d%7bfilter%7d%26fields%3d%7bfields%7d%26q%3d%7bq%7d%26qLimit%3d%7bqLimit%7d%26isAnonymous%3d%7bisAnonymous%7d%26responseFields%3d%7bresponseFields%7d

Retrieves a list of customer accounts.

GetCustomersPurchaseOrderAccounts POST purchaseOrderAccounts%3fstartIndex%3d%7bstartIndex%7d%26pageSize%3d%7bpageSize%7d%26sortBy%3d%7bsortBy%7d%26responseFields%3d%7bresponseFields%7d

Retrieves a list of customer purchase order accounts according to according to any specified sort options.

GetLoginState GET %7baccountId%7d%2floginstate%3fresponseFields%3d%7bresponseFields%7d

Retrieves the current login state of the customer account specified in the request.

GetLoginStateByEmailAddress POST loginstatebyemailaddress%3femailAddress%3d%7bemailAddress%7d%26responseFields%3d%7bresponseFields%7d

Retrieves the current login state of a customer account by providing the customer's email address.

GetLoginStateByUserName POST loginstatebyusername%3fuserName%3d%7buserName%7d%26customerSetCode%3d%7bcustomerSetCode%7d%26responseFields%3d%7bresponseFields%7d

Retrieves the current login state of a customer account by providing the user name associated with the customer account.

RecomputeCustomerLifetimeValue POST %7baccountId%7d%2frecomputelifetimevalue

Updates the customer lifetime value of the specified customer account in the event of an order import or a lifetime value calculation error.

ResetPassword POST Reset-Password

Resets the password for a customer account.

SetLoginLocked POST %7baccountId%7d%2fSet-Login-Locked

Lock or unlock a customer account.

SetPasswordChangeRequired POST %7baccountId%7d%2fSet-Password-Change-Required

Requires the password for the customer account to be changed.

UpdateAccount PUT %7baccountId%7d%3fresponseFields%3d%7bresponseFields%7d

Updates a customer account.