Shopify Fulfillment API Deprecation¶
Shopify has announced it is deprecating some endpoints on its Fulfillment API on June 30, 2023.
Customers with Cloud Studio projects using the deprecated Fulfillment API endpoints must make configuration changes as soon as possible, or operations using the deprecated API endpoints will begin failing after June 30, 2023.
Shopify had previously announced a deprecation date of March 31, 2023, which was later extended to June 30, 2023.
Impacted Projects and Required User Action¶
Cloud Studio projects using the Shopify connector are impacted if both of these conditions are met:
- The Shopify connection is configured with API version 2022-04.
- Shopify Create or Update activities associated with that connection are configured with deprecated Fulfillment API endpoints.
Follow these steps to determine if your projects using the Shopify connector are impacted and take the required user action:
Check the API version being used by each Shopify connection under Optional Settings > API Version.
If the selection is API version 2022-04, proceed to the next step. Otherwise, the project is not impacted.
It is not required to change the selected API version to a later version, as calls to the 2022-04 API version will automatically be redirected by Shopify to the 2022-07 API version. However, if you choose to change the selected API version at this time, see additional considerations in Change the API Version.
If present, change the object / sub-object selection as follows:
Shopify Activity Deprecated Object > Sub-object Recommendation Create Shipping and fulfillment > Fulfillment Change the selection to Shipping and fulfillment > Fulfillment for Fulfillment Order Create Shipping and fulfillment > Fulfillment Complete
These sub-objects do not have a direct replacement API endpoint. For recommendations see Shopify's migration guide Migrate to fulfillment orders.
Create Shipping and fulfillment > Open Fulfillment Update Shipping and fulfillment > Fulfillment
Once the configuration changes are made, you must redeploy the affected operations for the changes to take effect.
Cloud Studio projects interacting with Shopify's APIs directly, such as by using the HTTP or HTTP v2 (Beta) connector, may also be impacted. We recommend reviewing Shopify's migration guide Migrate to fulfillment orders to determine whether your projects are affected and make the appropriate updates.
If Required User Action Is Not Taken¶
After June 30, 2023, Shopify API calls to the 2022-04 API version will be redirected by Shopify to the 2022-07 API version. (Shopify automatically redirects calls of unsupported API versions to the next oldest supported version.)
As 2022-07 does not support the deprecated Fulfillment API endpoints, Cloud Studio operations that are deployed with the deprecated Shopify API endpoints will begin failing after June 30, 2023. Errors returned from the Shopify API will be reported in the operation logs.