API ReferenceEndpointsCustomersCustomers

Customers

Brainerce API reference: every customers operation, with its method, path and a page of its own.

Customers represent shoppers who have created an account in your store. A customer carries email, addresses, OAuth provider connections, saved payment methods, and order history. Use these endpoints to manage customer profiles, look up orders, and run the customer authentication flow (login, register, password reset, OAuth).

Customers operations

MethodEndpointOperation
POST/vc/{connectionId}/customers/registerRegister customer
POST/vc/{connectionId}/customers/loginSign in customer
POST/vc/{connectionId}/customers/forgot-passwordRequest password reset (Storefront)
POST/vc/{connectionId}/customers/reset-passwordReset password with token (Storefront)
GET/vc/{connectionId}/customers/meGet customer profile
PATCH/vc/{connectionId}/customers/meUpdate customer profile
GET/vc/{connectionId}/customers/me/checkout-prefillGet checkout prefill data
GET/vc/{connectionId}/customers/me/cartGet customer cart
GET/vc/{connectionId}/customers/me/addressesList customer addresses
POST/vc/{connectionId}/customers/me/addressesAdd customer address
PATCH/vc/{connectionId}/customers/me/addresses/{addressId}Update customer address
DELETE/vc/{connectionId}/customers/me/addresses/{addressId}Delete customer address
GET/vc/{connectionId}/customers/me/ordersList customer orders
GET/vc/{connectionId}/customers/me/orders/{orderId}/downloadsList order downloads
POST/vc/{connectionId}/customers/verify-emailVerify email
POST/vc/{connectionId}/customers/resend-verificationResend verification email
GET/vc/{connectionId}/oauth/providersList o auth providers
GET/vc/{connectionId}/oauth/{provider}/authorizeGet o auth authorize url
GET/vc/{connectionId}/oauth/{provider}/callbackHandle o auth callback
GET/vc/{connectionId}/customers/me/oauth-connectionsList customer o auth connections
POST/vc/{connectionId}/oauth/{provider}/linkLink o auth provider
DELETE/vc/{connectionId}/oauth/{provider}/linkUnlink o auth provider
GET/vc/{connectionId}/contact-formsList contact forms
GET/vc/{connectionId}/contact-forms/{formKey}Get contact form schema
POST/vc/{connectionId}/inquiriesCreate inquiry
POST/vc/{connectionId}/marketing/subscribeSubscribe to marketing email
GET/vc/{connectionId}/newsletter-benefitRead the newsletter signup benefit
GET/vc/{connectionId}/customers/me/wishlist/keysList every saved item (ids only)
GET/vc/{connectionId}/customers/me/wishlistList saved items, paginated (ids only)
POST/vc/{connectionId}/customers/me/wishlistSave an item
DELETE/vc/{connectionId}/customers/me/wishlistRemove a saved item
POST/vc/{connectionId}/customers/me/wishlist/mergeMerge the browser list into the account
GET/stores/{storeId}/newsletter-benefitRead the active newsletter signup benefit
POST/v1/customersCreate a new customer
GET/v1/customers/{id}Get a customer by ID
PATCH/v1/customers/{id}Update a customer
GET/v1/customers/by-emailGet a customer by email
POST/v1/customers/loginCustomer login
POST/v1/customers/registerCustomer registration
POST/v1/customers/forgot-passwordRequest password reset (Public API)
POST/v1/customers/reset-passwordReset password with token (Public API)
GET/v1/customers/{id}/addressesGet customer addresses
POST/v1/customers/{id}/addressesAdd a customer address
PATCH/v1/customers/{id}/addresses/{addressId}Update a customer address
DELETE/v1/customers/{id}/addresses/{addressId}Delete a customer address