When preparing event webhooks to send to apps like Mechanic, Shopify uses payloads as defined by a specific version of their Admin API.
Effective immediately, Shopify events in Mechanic now use webhook payloads from version 2025-01 of the Shopify Admin API.
⚠️ Historically, Shopify has based these payloads on REST Admin API resource representations. Per Shopify: The REST Admin API is a legacy API as of October 1, 2024. Moving forward, webhooks have their own definition and documentation, located at https://shopify.dev/docs/api/webhooks.
Breaking changes
Where Customer data appears in webhook payloads, Shopify has removed the following customer attributes in 2025-01 webhooks:
- tags‡
- email_marketing_consent
- sms_marketing_consent
- last_order_id,last_order_name,total_spent, andorders_count
‡ To ease the transition with
customer.tags
, we're partially patching for this: Mechanic Liquid provides background support for direct reference to tags
on Customer objects, even when responding to Shopify events that omit this customer attribute. (If you've got questions about this, head to slack.mechanic.dev!)Read more