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

# login

GraphQL MUTATION

Customer login.

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

## GraphQL Schema

```graphql
mutation ExampleMutation($email: String!, $password: String!, $guestCartEntityId: String) {
  login(email: $email, password: $password, guestCartEntityId: $guestCartEntityId) {
    result
    customer {
      entityId
      company
      customerGroupId
      customerGroupName
      email
      firstName
      lastName
      notes
      phone
      taxExemptCategory
    }
    cart {
      id
      entityId
      currencyCode
      displayCurrencyCode
      isTaxIncluded
      baseAmount
      baseAmountInDisplayCurrency
      discountedAmount
      discountedAmountInDisplayCurrency
      amount
    }
    customerAccessToken {
      value
      expiresAt
    }
  }
}
```

## Variables

```json
{
  "email": "example",
  "password": "example",
  "guestCartEntityId": "example"
}
```