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

# 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/2025-04/objects/AppUsageRecord)

  The newly created app usage record.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-04/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/2025-04/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).

***

## Map

### Mutations with this payload

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