Customers V2

  • Version: 2.0
  • Host:
  • Protocols: https
  • Accepts: application/json
  • Responds With: application/json
More Info

Create and Manage Customers, Customer Addresses, and Customer Groups. Additionally, validate customer passwords.

To learn more about Customers see here.

OAuth Scopes

UI Name Permission Parameter
Customers modify store_v2_customers
Customers read-only store_v2_customers_read_only

For more information on OAuth Scopes, see: Authentication.


Requests can be authenticated by sending a client_id and access_token via X-Auth-Client and X-Auth-Token HTTP headers:

GET /stores/store_hash/v3/catalog/summary
Accept: application/json
X-Auth-Client: {client_id}
X-Auth-Token: {access_token}
Header Parameter Description
X-Auth-Client client_id Obtained by creating an API account or installing an app in a BigCommerce control panel.
X-Auth-Token access_token Obtained by creating an API account or installing an app in a BigCommerce control panel.

For more information on Authenticating BigCommerce APIs, see: Authentication.

Available Endpoints

Resource / Endpoint Description
Customers Identity and account details for customers shopping on BigCommerce stores
Customers Addresses Postal address belonging to a customer.
Customers Groups Groupings of customers who share the same level of access and discounts
Customers Validate Password Validate customer passwords

Usage Notes

Customer Groups

  • Customer Groups are only available on specific plans.

Customers vs. Subscribers

  • A subscriber is not always a customer. Someone can sign up for the newsletter only and not create an account.
  • A customer is not always a subscriber. Signing up for the newsletter is a separate action from creating an account and purchasing an item.
  • A customer and a subscriber can be the same. If a shopper checks out on the storefront, creates an account and opts into the newsletter, they are a customer and a subscriber.


Related APIs / Endpoints

Customer Login API