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

# Customer​Activate​By​Url​Payload

payload

Return type for `customerActivateByUrl` mutation.

## Fields

* customer

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

  Token access required

  The customer that was activated.

* customer​Access​Token

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

  Token access required

  A new customer access token for the customer.

* customer​User​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl)

  mutation

  Activates a customer account using the full activation URL from the [`customerCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/customerCreate) mutation. This approach simplifies activation by accepting the complete URL directly, eliminating the need to parse it for the customer ID and activation token. Returns a [`CustomerAccessToken`](https://shopify.dev/docs/api/storefront/2026-04/objects/CustomerAccessToken) for authenticating subsequent requests.

  ***

  **Caution:** Store the returned access token securely. It grants access to the customer\&#39;s account data.

  ***

  * activation​Url

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

    required

    ### Arguments

    The customer activation URL.

  * password

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

    required

    A new password set during activation.

  ***

***

## Map

### Mutations with this payload

* [customer​Activate​By​Url](https://shopify.dev/docs/api/storefront/latest/mutations/customerActivateByUrl)
