---
title: Idempotent creation of AppUsageRecord - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/idempotent-creation-of-appusagerecord'
  md: 'https://shopify.dev/changelog/idempotent-creation-of-appusagerecord.md'
metadata:
  effectiveApiVersion: 2023-04
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2023-03-10T13:26:49-05:00'
  postedAt: '2023-03-10T00:00:00-05:00'
  updatedAt: '2024-12-13T17:24:37-05:00'
  effectiveAt: '2023-03-10T00:00:00-05:00'
---

March 10, 2023

Tags:

* API
* 2023-04

# Idempotent creation of AppUsageRecord

In the Admin GraphQL API version 2023-04, `appUsageRecordCreate` now supports an optional parameter `idempotencyKey` which ensures the merchant will not be charged twice. When `idempotencyKey` is provided, the mutation will return the same response as any previous `appUsageRecordCreate` mutations with identical `idempotencyKey` for the intended shop and requesting app, rather than creating a new record and charging the merchant again.

This means that an `idempotencyKey` could be reused by an app to create `appUsageRecord`s on different shops to charge the merchant. Different apps can also use the same `idempotencyKey` on the same shop and still charge the shop. But we recommend a UUID.

The `appUsageRecordCreate` will behave like past API versions when `idempotencyKey` is not provided and create a new record on every mutation.