> This page is for Developer.

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

# customerCreate

GraphQL MUTATION

Create a new Bigcommerce customer

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/b2b/b2b-graphql/mutations/customer-create

## GraphQL Schema

```graphql
mutation ExampleMutation($customerData: CustomerInputType!, $recaptchaUserResponse: String) {
  customerCreate(customerData: $customerData, recaptchaUserResponse: $recaptchaUserResponse) {
    customer {
      id
      email
      firstName
      lastName
      company
      phone
      notes
      taxExemptCategory
      registrationIpAddress
      customerGroupId
    }
  }
}
```

## Variables

```json
{
  "customerData": {
    "storeHash": "example",
    "email": "example",
    "firstName": "example",
    "lastName": "example",
    "company": "example",
    "phone": "example",
    "notes": "example",
    "addresses": [
      {
        "firstName": "example",
        "lastName": "example",
        "company": "example",
        "address1": "example",
        "address2": "example",
        "city": "example",
        "phone": "example",
        "stateOrProvince": "example",
        "countryCode": "example",
        "postalCode": "example"
      }
    ],
    "authentication": {
      "forcePasswordReset": true,
      "newPassword": "example"
    },
    "acceptsProductReviewAbandonedCartEmails": true
  },
  "recaptchaUserResponse": ""
}
```