From bigcommerce-commerce
Manages BigCommerce customers via REST API: CRUD for customers/addresses/attributes, groups, SSO login, form fields, settings, and segmentation for data integrations.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin bigcommerce-commerceThis skill is limited to using the following tools:
**Fetch live docs**:
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Fetch live docs:
site:developer.bigcommerce.com rest customers for Customers API referencehttps://developer.bigcommerce.com/docs/start/authentication/customer-login for Customer Login APIbigcommerce customer groups api for customer group management| Endpoint | Methods | Description |
|---|---|---|
/v3/customers | GET, POST, PUT, DELETE | Customer CRUD |
/v3/customers/addresses | GET, POST, PUT, DELETE | Customer addresses |
/v3/customers/attributes | GET, POST, PUT, DELETE | Custom attribute definitions |
/v3/customers/attribute-values | GET, PUT, DELETE | Attribute values per customer |
/v3/customers/form-field-values | GET, PUT | Form field values |
/v3/customers/settings | GET, PUT | Customer settings |
Core fields:
id, email, first_name, last_name, companyphone, date_created, date_modifiedcustomer_group_id — assigned groupnotes — admin notesregistration_ip_addressauthentication — password or external authPOST /v3/customers
[{
"email": "customer@example.com",
"first_name": "Jane",
"last_name": "Doe",
"authentication": {
"new_password": "SecurePassword123!"
}
}]
Note: V3 accepts arrays — batch create/update multiple customers at once.
Segment customers for pricing, access, and promotions:
GET /v2/customer_groups — list groupsPOST /v2/customer_groups — create groupcustomer_group_id field on customer| Group | Description |
|---|---|
| Guest | Non-logged-in visitors |
| Default | Default for new customers |
| Custom groups | Merchant-defined segments |
POST /v3/customers/addresses
[{
"customer_id": 123,
"first_name": "Jane",
"last_name": "Doe",
"address1": "123 Main St",
"city": "Austin",
"state_or_province": "Texas",
"postal_code": "78701",
"country_code": "US",
"address_type": "residential"
}]
Create custom fields for customer profiles:
POST /v3/customers/attributes
[{
"name": "Loyalty Tier",
"type": "string"
}]
Types: string, number, date, dropdown
Set per customer:
PUT /v3/customers/attribute-values
[{
"customer_id": 123,
"attribute_id": 1,
"value": "Gold"
}]
Log customers into BigCommerce storefront from an external system:
https://{store_url}/login/token/{jwt}{
"iss": "your_client_id",
"iat": 1706140800,
"jti": "unique-request-id",
"operation": "customer_login",
"store_hash": "abc123",
"customer_id": 456,
"redirect_to": "/account",
"channel_id": 1
}
Sign with HMAC-SHA256 using your Client Secret.
For accessing customer-specific data in the GraphQL Storefront API:
POST /v3/storefront/api-token-customer-impersonationX-Bc-Customer-Id: {customer_id} headerid:in=1,2,3 — by IDsemail:in=a@b.com,c@d.com — by emailsname:like=Jane — name searchcustomer_group_id:in=5,6 — by groupdate_created:min=2024-01-01 — date rangeinclude=addresses,attributes — include sub-resourcesFetch the BigCommerce Customers API reference and Customer Login API documentation for exact endpoints, JWT format, and attribute types before implementing.