---
title: AppSubscriptionCreatePayload - GraphQL Admin
description: Return type for `appSubscriptionCreate` mutation.
api_version: 2025-01
api_name: admin
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/payloads/appsubscriptioncreatepayload
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/payloads/appsubscriptioncreatepayload.md
---

# App​Subscription​Create​Payload

payload

Return type for `appSubscriptionCreate` mutation.

## Fields

* app​Subscription

  [App​Subscription](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/AppSubscription)

  The newly-created app subscription.

* confirmation​Url

  [URL](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/URL)

  The URL pointing to the page where the merchant approves or declines the charges for an app subscription.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [app​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/appSubscriptionCreate)

  mutation

  Creates a recurring or usage-based [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription) that charges merchants for app features and services. The subscription includes one or more [`AppSubscriptionLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem) objects that define the pricing structure, billing intervals, and optional [`AppSubscriptionDiscount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionDiscount) values.

  Returns a [confirmation URL](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate#returns-confirmationUrl) where the merchant approves or declines the charges. After approval, the subscription becomes active and billing begins after any trial period expires. You can specify [`AppSubscriptionReplacementBehavior`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppSubscriptionReplacementBehavior) to control how this subscription interacts with existing active subscriptions.

  Learn more about [creating app subscriptions](https://shopify.dev/docs/apps/launch/billing/subscription-billing/create-time-based-subscriptions).

***

## Map

### Mutations with this payload

* [app​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/types/appSubscriptionCreate)