> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# Customers V2

Create and Manage Customers, Customer Addresses, and Customer Groups. Additionally, validate customer passwords. To learn more about Customers see the [Customers Overview](/developer/docs/admin/customers).

## 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.

## Resources

### Related APIs / Endpoints

* [Customer Login API](/developer/docs/storefront/guides/customer-authentication/customer-login)
* [Current Customer API](/developer/docs/storefront/guides/customer-authentication/current-customer)
* [Customers API (v3)](/developer/api-reference/rest/admin/management/customers/v3)
* [Subscribers API](/developer/api-reference/rest/admin/management/subscribers)

### Webhooks

* [Customers](/developer/docs/integrations/webhooks/event-reference#customer)

> Build amazing commerce solutions powered by the BigCommerce platform


## API Docs

- Admin Management: Customers V2 [List Customers](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/get-customers.md)
- Admin Management: Customers V2 [Create Customer](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/create-customer.md)
- Admin Management: Customers V2 [Delete Customers](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/delete-customers.md)
- Admin Management: Customers V2 [Get Customer](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/get-customer.md)
- Admin Management: Customers V2 [Update Customer](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/update-customer.md)
- Admin Management: Customers V2 [Delete Customer](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/delete-customer.md)
- Admin Management: Customers V2 [Get Count of Customers](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/get-customers-count.md)
- Admin Management: Customers V2 > Customer Addresses [List Customer Addresses](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/get-customer-addresses.md)
- Admin Management: Customers V2 > Customer Addresses [Create Customer Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/create-customer-address.md)
- Admin Management: Customers V2 > Customer Addresses [Delete Customer Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/delete-customer-addresses.md)
- Admin Management: Customers V2 > Customer Addresses [Get Customer Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/get-customer-address.md)
- Admin Management: Customers V2 > Customer Addresses [Update Customer Address](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/update-customer-address.md)
- Admin Management: Customers V2 > Customer Addresses [Get Count of Customer Addresses](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-addresses/get-customer-addresses-count.md)
- Admin Management: Customers V2 > Customer Groups [List Customer Groups](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/get-customer-groups.md)
- Admin Management: Customers V2 > Customer Groups [Create Customer Group](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/create-customer-group.md)
- Admin Management: Customers V2 > Customer Groups [Get Customer Group](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/get-customer-group.md)
- Admin Management: Customers V2 > Customer Groups [Update Customer Group](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/update-customer-group.md)
- Admin Management: Customers V2 > Customer Groups [Delete Customer Group](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/delete-customer-group.md)
- Admin Management: Customers V2 > Customer Groups [Get Count of Customer Groups](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-groups/get-customer-groups-count.md)
- Admin Management: Customers V2 > Customer Passwords [Validate Password](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/customer-passwords/validate-customer-password.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/customers/v2/openapi.yaml)