---
title: AppUsageRecordCreatePayload - GraphQL Admin
description: Return type for `appUsageRecordCreate` mutation.
api_version: 2025-10
api_name: admin
type: payload
api_type: graphql
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
---

# 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

  Enables an app to charge a store for features or services on a per-use basis. The usage charge value is counted towards the `cappedAmount` limit that was specified in the `appUsagePricingDetails` field when the app subscription was created. If you create an app usage charge that causes the total usage charges in a billing interval to exceed the capped amount, then a `Total price exceeds balance remaining` error is returned.

***

## Map

### Mutations with this payload

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