---
title: AppUsageRecordCreatePayload - GraphQL Admin
description: Return type for `appUsageRecordCreate` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AppUsageRecordCreatePayload
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/payloads/AppUsageRecordCreatePayload.md
api_name: admin
api_type: graphql
type: payload
---

# App​Usage​Record​Create​Payload

payload

Return type for `appUsageRecordCreate` mutation.

## Fields

* app​Usage​Record

  [App​Usage​Record](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppUsageRecord)

  The newly created app usage record.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [app​Usage​Record​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appUsageRecordCreate)

  mutation

  Creates a usage charge for an app subscription with usage-based pricing. The charge counts toward the capped amount limit set when creating the subscription.

  Usage records track consumption of app features or services on a per-use basis. You provide the charge amount, a description of what you consumed, and the subscription line item ID. The optional [`idempotencyKey`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppUsageRecord#field-idempotencyKey) parameter prevents duplicate charges if you send the same request multiple times.

  If the new charge would cause total usage charges in the current billing interval to exceed the capped amount, then the mutation returns an error.

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

  * description

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

    required

    ### Arguments

    The description of the app usage record.

  * idempotency​Key

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    A unique key generated by the client to avoid duplicate charges. Maximum length of 255 characters.

  * price

    [Money​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/MoneyInput)

    required

    The price of the app usage record.

  * subscription​Line​Item​Id

    [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

    required

    The ID of the app subscription line item to create the usage record under. This app subscription line item must have a usage pricing plan.

  ***

***

## Map

### Mutations with this payload

* [app​Usage​Record​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appUsageRecordCreate)