{"errors":"The api_client does not have the required permission(s)."}

Topic summary

A developer is encountering a permissions error when attempting to create fulfillments for Shopify orders through the API.

The workflow:

  • Successfully requested granular access scopes via POST to /admin/request_granular_access_scopes.json, including read/write permissions for merchant-managed, third-party, and assigned fulfillment orders
  • Initially able to GET fulfillment orders successfully after permission grant
  • After some time period, receiving error: “The api_client does not have the required permission(s)” when attempting the same GET request

Key issue:
The permissions appear to be lost or revoked after the initial successful access, despite no apparent changes to the access token or scope configuration. The developer is seeking clarification on why the corresponding permissions were removed or became invalid after working initially.

Summarized with AI on November 16. AI used: claude-sonnet-4-5-20250929.

recently we have a case where we made fulfillment into orders.
1、Firstly, we call the interface to obtain permissions
【POST】URL:https://rockbros-eu.myshopify.com/admin/request_granular_access_scopes.json
postData:{“requested_scopes”:[“read_merchant_managed_fulfillment_orders”,“read_third_party_fulfillment_orders”,“read_assigned_fulfillment_orders”,“write_merchant_managed_fulfillment_orders”,“write_third_party_fulfillment_orders”,“write_assigned_fulfillment_orders”]}
[Header]{Content-Type=application/json, X-Shopify-Access-Token=80****d1}

【response】
{“access_scopes”:[{“handle”:“read_products”},{“handle”:“read_customers”},{“handle”:“write_orders”},{“handle”:“write_inventory”},{“handle”:“write_fulfillments”},{“handle”:“read_merchant_managed_fulfillment_orders”},{“handle”:“read_third_party_fulfillment_orders”},{“handle”:“read_assigned_fulfillment_orders”},{“handle”:“write_merchant_managed_fulfillment_orders”},{“handle”:“write_third_party_fulfillment_orders”},{“handle”:“write_assigned_fulfillment_orders”},{“handle”:“read_orders”},{“handle”:“read_inventory”},{“handle”:“read_fulfillments”}]}

2、We get fulfillment_orders success
【GET】https://rockbros-eu.myshopify.com/admin/api/2023-07/orders/5743773516121/fulfillment_orders.json
[Header]{X-Shopify-Access-Token=809****9d1, Content-Type=application/json}

【response】
{“fulfillment_orders”:[{****************,“merchant_requests”:}]}

3、However, after a period of time, we still receive an error message({“errors”:“The api_client does not have the required permission(s).”}). May I ask why the corresponding permissions were lost

【GET】https://rockbros-eu.myshopify.com/admin/api/2023-07/orders/5743502590297/fulfillment_orders.json
[Header]{X-Shopify-Access-Token=****1, Content-Type=application/json}

{“errors”:“The api_client does not have the required permission(s).”}