Shopify REST Admin API deprecation notice

Shopify is deprecating their REST Admin API and requiring all users to migrate to their GraphQL Admin API. This change affects all Cloudhooks users who have automations and integrations that interact with Shopify's Admin API.

Key deadlines

• Immediate action required: Verify GraphQL API permissions for Cloudhooks‍
• January 31, 2025: All Shopify REST Admin API calls must be migrated to GraphQL

What this means for Cloudhooks users

Store owners

If you're using Cloudhooks for your Shopify store automations, you'll need to review your existing hooks and ensure they're updated before the deadline. Here's what you should do:

• First Priority: Verify your GraphQL API permissions (see "Verifying API permissions" section below)
• Review all your active hooks in your Cloudhooks dashboard
• Identify hooks that interact with Shopify's Admin REST API
• Work with your development team or contact your hook creator to update the code
• Test the updated hooks thoroughly before the deadline

Store developers

If you've created hooks for Cloudhooks users, you'll need to update your code to use GraphQL instead of REST. Here's what you need to know:

• All Shopify Admin API operations must use GraphQL by January 31, 2025
• Familiarize yourself with Shopify's GraphQL Admin API documentation
• Test your updated hooks extensively to ensure functionality
• Communicate with your clients about the necessary updates

Common API operations affected (January 31, 2025 deadline)

• Product creation and updates
• Variant management
• Image handling
• Collection management
• Metadata and tags
• Inventory control
• Orders and fulfillment
• Customer data
• Discounts and pricing
• Shipping and delivery
• Store configuration
• Content management
• Payment operations

Verifying API permissions

Shopify has automatically backfilled the necessary GraphQL API permissions for all stores. However, stores should verify their permissions:

1) Go to the "Settings" page of Cloudhooks in your Shopify admin:

2) Check if you see an "App permissions" pane

• If you don't see this pane, your permissions are already set up correctly
• If you do see the pane, you'll need to upgrade your permissions by clicking the "Authorize" button:

3) Shopify will prompt you for approving the permissions

If you see the "App permissions" pane, completing this verification step is crucial before the migration deadline.

Resources and support

To help with this transition, we recommend the following resources:

• Shopify GraphQL Admin API documentation
• Shopify GraphQL migration guide
• Cloudhooks GraphQL action reference
• GraphQL learning resources
• Shopify community forums and discussions

How Cloudhooks can help

We're actively supporting all users through this transition with:

• Regular updates and reminders about deadline
• Technical documentation for GraphQL implementation
• Migration assistance where possible
• Cloudhooks GPT for code generation: We offer a specialized AI assistant that can help draft GraphQL-based hooks. Available to ChatGPT Plus subscribers, Cloudhooks GPT can help you:
  • Convert existing REST hooks to GraphQL
  • Generate new hooks using GraphQL queries
  • Understand proper GraphQL query structure
  • Learn best practices for Shopify's GraphQL Admin API

To get started with Cloudhooks GPT:

1. Read our Cloudhooks GPT guide and official announcement
2. Visit Cloudhooks GPT (requires ChatGPT Plus subscription)
3. Describe your hook's requirements in plain English
4. Review and test the generated code
5. Refine the code with follow-up prompts as needed

Frequently Asked Questions

What happens if I don't update my hooks?

After the deadlines, hooks using the Shopify REST Admin API will stop working. This could disrupt your store's automations and operations.

Can I simply convert my REST API calls to GraphQL one-for-one?

GraphQL requires a different approach than REST. While some operations can be directly converted, others will require restructuring and may need multiple steps to achieve the same result. You'll need to learn GraphQL's specific way of handling store resources to make the transition successfully.

What about REST API calls to non-Shopify services?

REST API calls made to external services are not affected by this transition (like your own backend services, membership systems, email and messaging automation tools, analytics tools). This change only applies to API calls made directly to Shopify's Admin API. Your hooks can continue using REST APIs for non-Shopify integrations while using GraphQL for Shopify-specific operations.

Can I update hooks gradually?

Yes, you can update hooks one at a time. Just ensure that all hooks using Shopify’s REST Admin API are updated by January 31, 2025.

Will this affect my store's performance?

No. In fact, properly implemented GraphQL API calls may improve performance since you can request exactly the data you need in a single call, potentially reducing server load and response times.

Conclusion

While this change requires attention and action, it's an opportunity to improve your store's automations. The GraphQL Admin API offers greater flexibility and efficiency by letting you request exactly the data you need in a single call, reducing unnecessary data transfer and potentially speeding up your operations in the long run.

Remember the key deadlines:

• Immediate action required: Verify GraphQL API permissions
• January 31, 2025: All REST Admin API operations must be migrated to GraphQL

If you haven't verified your API permissions status, this should be your first priority before proceeding with any other changes.

We're here to help ensure a smooth transition. Contact our support team if you need assistance or have questions about this migration process.

‍