---
title: CustomerAccessTokenRenewPayload - Storefront API
description: Return type for `customerAccessTokenRenew` mutation.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/CustomerAccessTokenRenewPayload
  md: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/CustomerAccessTokenRenewPayload.md
api_name: storefront
api_type: graphql
type: payload
---

# Customer​Access​Token​Renew​Payload

payload

Return type for `customerAccessTokenRenew` mutation.

## Fields

* customer​Access​Token

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

  Token access required

  The renewed customer access token object.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [customer​Access​Token​Renew](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenRenew)

  mutation

  Extends the validity of a [`CustomerAccessToken`](https://shopify.dev/docs/api/storefront/2026-04/objects/CustomerAccessToken) before it expires. The renewed token maintains authenticated access to customer operations.

  Renewal must happen before the token's [`expiresAt`](https://shopify.dev/docs/api/storefront/2026-04/objects/CustomerAccessToken#field-CustomerAccessToken.fields.expiresAt) time. If a token has already expired, then use [`customerAccessTokenCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/customerAccessTokenCreate) to generate a new token with the customer's credentials.

  ***

  **Caution:** Store access tokens securely. Never store tokens in plain text or insecure locations, and avoid exposing them in URLs or logs.

  ***

  * customer​Access​Token

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

    required

    ### Arguments

    The access token used to identify the customer.

  ***

***

## Map

### Mutations with this payload

* [customer​Access​Token​Renew](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenRenew)