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

# customer

GraphQL MUTATION

The customer mutations.

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

## GraphQL Schema

```graphql
mutation ExampleMutation($changePasswordInput: ChangePasswordInput!, $requestResetPasswordInput: RequestResetPasswordInput!, $resetPasswordInput: ResetPasswordInput!, $registerCustomerInput: RegisterCustomerInput!, $updateCustomerInput: UpdateCustomerInput!) {
  customer {
    changePassword(input: $changePasswordInput) {
      errors {
        __typename
        ... on ValidationError {
          message
          path
        }
      }
    }
    requestResetPassword(input: $requestResetPasswordInput) {
      errors {
        __typename
        ... on ValidationError {
          message
          path
        }
      }
    }
    resetPassword(input: $resetPasswordInput) {
      errors {
        __typename
        ... on ValidationError {
          message
          path
        }
      }
    }
    registerCustomer(input: $registerCustomerInput) {
      customer {
        entityId
        company
        customerGroupId
        customerGroupName
        email
        firstName
        lastName
        notes
        phone
        taxExemptCategory
      }
      errors {
        __typename
        ... on EmailAlreadyInUseError {
          message
        }
      }
    }
    updateCustomer(input: $updateCustomerInput) {
      customer {
        entityId
        company
        customerGroupId
        customerGroupName
        email
        firstName
        lastName
        notes
        phone
        taxExemptCategory
      }
      errors {
        __typename
        ... on UnexpectedUpdateCustomerError {
          message
        }
      }
    }
  }
}
```

## Variables

```json
{
  "changePasswordInput": {
    "currentPassword": "example",
    "newPassword": "example"
  },
  "requestResetPasswordInput": {
    "email": "example",
    "path": "example"
  },
  "resetPasswordInput": {
    "customerEntityId": 0,
    "token": "example",
    "newPassword": "example"
  },
  "registerCustomerInput": {
    "firstName": "example",
    "lastName": "example",
    "email": "example",
    "password": "example",
    "phone": "example",
    "company": "example",
    "address": {
      "firstName": "example",
      "lastName": "example",
      "address1": "example",
      "address2": "example",
      "city": "example",
      "company": "example",
      "countryCode": "example",
      "stateOrProvince": "example",
      "phone": "example",
      "postalCode": "example"
    },
    "formFields": {
      "checkboxes": [
        {
          "fieldEntityId": 0,
          "fieldValueEntityIds": [
            0
          ]
        }
      ],
      "multipleChoices": [
        {
          "fieldEntityId": 0,
          "fieldValueEntityId": 0
        }
      ],
      "numbers": [
        {
          "fieldEntityId": 0,
          "number": 0
        }
      ],
      "dates": [
        {
          "fieldEntityId": 0,
          "date": "2026-11-12T01:32:17.809Z"
        }
      ],
      "texts": [
        {
          "fieldEntityId": 0,
          "text": "example"
        }
      ],
      "multilineTexts": [
        {
          "fieldEntityId": 0,
          "multilineText": "example"
        }
      ],
      "passwords": [
        {
          "fieldEntityId": 0,
          "password": "example"
        }
      ]
    }
  },
  "updateCustomerInput": {
    "firstName": "example",
    "lastName": "example",
    "email": "example",
    "phone": "example",
    "company": "example",
    "formFields": {
      "checkboxes": [
        {
          "fieldEntityId": 0,
          "fieldValueEntityIds": [
            0
          ]
        }
      ],
      "multipleChoices": [
        {
          "fieldEntityId": 0,
          "fieldValueEntityId": 0
        }
      ],
      "numbers": [
        {
          "fieldEntityId": 0,
          "number": 0
        }
      ],
      "dates": [
        {
          "fieldEntityId": 0,
          "date": "2026-11-12T01:32:17.810Z"
        }
      ],
      "texts": [
        {
          "fieldEntityId": 0,
          "text": "example"
        }
      ],
      "multilineTexts": [
        {
          "fieldEntityId": 0,
          "multilineText": "example"
        }
      ],
      "passwords": [
        {
          "fieldEntityId": 0,
          "password": "example"
        }
      ]
    }
  }
}
```