For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
    • About Our APIs
  • REST
    • Overview
  • GraphQL
    • Overview
      • Playground
          • MUTproductUpload
          • MUTproductAnonUpload
          • MUTupdateAccountSettings
          • MUTupdateCustomerAccountSettings
          • MUTinvoicePdf
          • MUTinvoicesExport
          • MUTinvoiceCreateBcCart
          • MUTinvoiceFinishBcPayment
          • MUTcreateOrder
          • MUTshoppingListsCreate
          • MUTshoppingListsUpdate
          • MUTshoppingListsDelete
          • MUTshoppingListsDuplicate
          • MUTshoppingListsItemsCreate
          • MUTshoppingListsItemsUpdate
          • MUTshoppingListsItemsDelete
          • MUTcustomerShoppingListsCreate
          • MUTcustomerShoppingListsUpdate
          • MUTcustomerShoppingListsDelete
          • MUTcustomerShoppingListsDuplicate
          • MUTcustomerShoppingListsItemsCreate
          • MUTcustomerShoppingListsItemsUpdate
          • MUTcustomerShoppingListsItemsDelete
          • MUTquoteCreate
          • MUTquoteUpdate
          • MUTquoteCheckout
          • MUTquoteOrdered
          • MUTquoteEmail
          • MUTquotePdfExport
          • MUTquoteAttachFileDelete
          • MUTquoteAttachFileCreate
          • MUTquoteFrontendPdf
          • MUTsuperAdminBeginMasquerade
          • MUTsuperAdminEndMasquerade
          • MUTcompanyCreate
          • MUTlogin
          • MUTcheckoutLogin
          • MUTauthorization
          • MUTuserCreate
          • MUTuserUpdate
          • MUTuserDelete
          • MUTstoreFrontToken
          • MUTcustomerCreate
          • MUTcustomerSubscribersCreate
          • MUTuserMasqueradingCompanyBegin
          • MUTuserMasqueradingCompanyEnd
          • MUTaddressCreate
          • MUTaddressUpdate
          • MUTaddressDelete
          • MUTcustomerAddressCreate
          • MUTcustomerAddressUpdate
          • MUTcustomerAddressDelete
  • MCP
    • Overview
Dev Portal
LogoLogo
GraphQLB2BMutations

customerCreate

Example Query
1mutation ExampleMutation($customerData: CustomerInputType, $recaptchaUserResponse: String) {
2 customerCreate(customerData: $customerData, recaptchaUserResponse: $recaptchaUserResponse) {
3 customer {
4 id
5 email
6 firstName
7 lastName
8 company
9 phone
10 notes
11 taxExemptCategory
12 registrationIpAddress
13 customerGroupId
14 }
15 }
16}
Variables
1{
2 "customerData": {
3 "storeHash": "example",
4 "email": "example",
5 "firstName": "example",
6 "lastName": "example",
7 "company": "example",
8 "phone": "example",
9 "notes": "example",
10 "addresses": [
11 {
12 "firstName": "example",
13 "lastName": "example",
14 "company": "example",
15 "address1": "example",
16 "address2": "example",
17 "city": "example",
18 "phone": "example",
19 "stateOrProvince": "example",
20 "countryCode": "example",
21 "postalCode": "example"
22 }
23 ],
24 "authentication": {
25 "forcePasswordReset": true,
26 "newPassword": "example"
27 },
28 "acceptsProductReviewAbandonedCartEmails": true
29 },
30 "recaptchaUserResponse": ""
31}
Example response
1{
2 "data": {
3 "customerCreate": {
4 "customer": {
5 "id": 0,
6 "email": "example",
7 "firstName": "example",
8 "lastName": "example",
9 "company": "example",
10 "phone": "example",
11 "notes": "example",
12 "taxExemptCategory": "example",
13 "registrationIpAddress": "example",
14 "customerGroupId": 0
15 }
16 }
17 }
18}
Create a new Bigcommerce customer
Was this page helpful?
Previous

storeFrontToken

Next

customerSubscribersCreate

Built with

Arguments

customerDataCustomerInputTypeRequired
An object with customer data. This field is required.
recaptchaUserResponseStringOptional
The recaptcha user response token.

Returns

an optional CustomerCreate
customerCustomerType