---
title: appCreditCreate - Partner API
description: >-
  Allows an app to create a credit for a shop that can be used towards future
  app purchases. This mutation is only available to Partner API clients that
  have been granted the `View financials` permission.
api_version: unstable
api_name: partner
source_url:
  html: 'https://shopify.dev/docs/api/partner/unstable/mutations/appCreditCreate'
  md: 'https://shopify.dev/docs/api/partner/unstable/mutations/appCreditCreate.md'
---

# app​Credit​Create

mutation

Allows an app to create a credit for a shop that can be used towards future app purchases. This mutation is only available to Partner API clients that have been granted the `View financials` permission.

## Arguments

* amount

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

  required

  The amount that can be used towards future app purchases in Shopify.

* app​Id

  [ID!](https://shopify.dev/docs/api/partner/unstable/scalars/ID)

  required

  The id of the app to associate the credit with. Example value: `gid://partners/App/123`.

* description

  [String!](https://shopify.dev/docs/api/partner/unstable/scalars/String)

  required

  The description of the app credit.

* shop​Id

  [ID!](https://shopify.dev/docs/api/partner/unstable/scalars/ID)

  required

  The id of the shop to be credited. Example value: `gid://partners/Shop/456`.

* test

  [Boolean](https://shopify.dev/docs/api/partner/unstable/scalars/Boolean)

  Default:false

  Specifies whether the app credit is a test transaction.

***

## App​Credit​Create​Payload returns

* app​Credit

  [App​Credit](https://shopify.dev/docs/api/partner/unstable/objects/AppCredit)

  The app credit that was created.

* user​Errors

  [\[User​Error!\]](https://shopify.dev/docs/api/partner/unstable/objects/UserError)

  Errors when creating the application credit.

***

## Examples

* ### appCreditCreate reference

## Mutation Reference

```graphql
mutation appCreditCreate($appId: ID!, $shopId: ID!, $amount: MoneyInput!, $description: String!, $test: Boolean) {
  appCreditCreate(appId: $appId, shopId: $shopId, amount: $amount, description: $description, test: $test) {
    appCredit {
      # AppCredit fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "appId": "gid://shopify/<objectName>/10079785100",
  "shopId": "gid://shopify/<objectName>/10079785100",
  "amount": {
    "amount": "29.99",
    "currencyCode": "CYP"
  },
  "description": "<your-description>",
  "test": true
}
```

##### Variables

```
{
  "appId": "gid://shopify/<objectName>/10079785100",
  "shopId": "gid://shopify/<objectName>/10079785100",
  "amount": {
    "amount": "29.99",
    "currencyCode": "CYP"
  },
  "description": "<your-description>",
  "test": true
}
```

##### Schema

```
input MoneyInput {
  amount: Decimal
  currencyCode: Currency
}
```