---
title: customerAccessTokenRenew - Storefront API
description: |
  Renews a customer access token.

  Access token renewal must happen *before* a token expires.
  If a token has already expired, a new one should be created instead via `customerAccessTokenCreate`.
api_version: 2025-04
api_name: storefront
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/2025-04/mutations/customeraccesstokenrenew
  md: https://shopify.dev/docs/api/storefront/2025-04/mutations/customeraccesstokenrenew.md
---

# customer​Access​Token​Renew

mutation

Requires `unauthenticated_write_customers` access scope.

Renews a customer access token.

Access token renewal must happen *before* a token expires. If a token has already expired, a new one should be created instead via `customerAccessTokenCreate`.

## Arguments

* customer​Access​Token

  [String!](https://shopify.dev/docs/api/storefront/2025-04/scalars/String)

  required

  The access token used to identify the customer.

***

## Customer​Access​Token​Renew​Payload returns

* customer​Access​Token

  [Customer​Access​Token](https://shopify.dev/docs/api/storefront/2025-04/objects/CustomerAccessToken)

  The renewed customer access token object.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/storefront/2025-04/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerAccessTokenRenew reference

## Mutation Reference

```graphql
mutation customerAccessTokenRenew($customerAccessToken: String!) {
  customerAccessTokenRenew(customerAccessToken: $customerAccessToken) {
    customerAccessToken {
      # CustomerAccessToken fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "customerAccessToken": "<your-customerAccessToken>"
}
```

##### Variables

```
{
  "customerAccessToken": "<your-customerAccessToken>"
}
```