Can not use appSubscriptionCreate

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Issue: appSubscriptionCreate (GraphQL billing mutation) returns “Access denied” when following the combined time/usage-based subscription guide. Using the Shopify App Remix v2 billing APIs works, but a more flexible approach is needed. The user asked if replies could be in Chinese.

Details: The error payload shows ACCESS_DENIED on appSubscriptionCreate with a link to access scopes. A screenshot indicates the mutation was attempted via the Shopify GraphiQL app.

Root cause (support response): The Shopify GraphiQL app cannot be used to register app billing because it uses a fixed access token from a Shopify-owned app and doesn’t allow changing the token. Billing mutations must be executed with the merchant-installed app’s own access token.

Recommended actions:

  • Make the appSubscriptionCreate call using your app’s access token.
  • Use tools like Postman or Insomnia to supply your token and run the mutation.

Outcome/Status: The user will try Postman. No further issues reported; resolution appears pending validation. Attachments: Screenshot helped identify the use of the Shopify GraphiQL app as the context of the failure.

Summarized with AI on December 30. AI used: gpt-5.
1

use the code

https://shopify.dev/docs/apps/billing/subscriptions/combined-time-usage-based#step-1-create-the-subscription

but it dose not work

use https://shopify.dev/docs/api/shopify-app-remix/v2/apis/billing it work.

but I need a more flexible way

能用中文回复吗？感谢。

Can you reply in Chinese? grateful.

{
  "errors": [
    {
      "message": "Access denied for appSubscriptionCreate field.",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "appSubscriptionCreate"
      ],
      "extensions": {
        "code": "ACCESS_DENIED",
        "documentation": "https://shopify.dev/api/usage/access-scopes"
      }
    }
  ],
  "data": {
    "appSubscriptionCreate": null
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 22,
      "actualQueryCost": 10,
      "throttleStatus": {
        "maximumAvailable": 2000,
        "currentlyAvailable": 1990,
        "restoreRate": 100
      }
    }
  }
}

xBeiQiu_0-1714065694632.png
xBeiQiu_0-1714065694632.png2472×1315 264 KB

2

Hi @xBei-Qiu ,

Looking at the screenshot we can see that the API request is failing inside the Shopify GraphiQL app. This app cannot be used for registering app billing because it is an app created by Shopify and does not allow changing of the access token that is used.

To register app billing you need to be making the appSubscriptionCreate API call using the access token from your own app.

Tools like Postman and Insomnia are good alternative user interfaces for making API calls that allow using your own access token.

Hope you have a great day

3

thank you, i try it in Posman first.

good day.