Home
Changelog
System contact email customization now available
new
Historically, Mechanic has sent its required system notice messages to the store owner's email address, as recorded by Shopify.
The email recipient for these messages may now be customized, via the "System contact email" field in the store's Mechanic app settings. This value defaults to the store owner's email address.
New connection verification options for FTP actions
new
The FTP action now supports host certificate verification for SFTP connections, via
"verify": true
and a configured
"known_hosts"
string. And, for FTPS connections, host certificate validation may now be electively skipped, using
"verify": false
.
Read more
"Full request" mode and file uploads now available for Mechanic webhooks
new
Mechanic webhooks may now be configured with a choice of event data modes, determining the method by which webhook request data is translated into event data.
As an alternative to "Auto" (the default, and Mechanic's historically available behavior), webhooks may be set to use "Full request" mode. This new mode makes available most aspects of a request, including the query string, headers, request body, and useful interpreted versions of those values.
All Mechanic webhooks (including both event data modes) now also support file uploads, via multipart/form-data requests.
Read more
New monthly scheduler event topic: mechanic/scheduler/monthly
new
Scheduling on the 1st of month is now available, via the new mechanic/scheduler/monthly event topic.
Shopify admin action links: Send resources to Mechanic on demand
new
This integration with the Shopify admin allows you to send customers, orders, draft orders, abandoned checkouts, products, product variants, and collections to Mechanic for processing. "Send to Mechanic" links can create simpler workflows for you and your users.
To qualify your tasks to receive Shopify resources via admin action links, subscribe to mechanic/user/{resource(s)} – e.g. mechanic/user/product, mechanic/user/orders, etc.
Find "Send to Mechanic" links in the Shopify admin. These links are available in the bulk actions available on lists of resources:
image
... and in the actions available for individual resources:
image
Upon landing in Mechanic, the user may choose between two processing modes:
  • Batch mode — In this mode, an event is created whose data is an array of all selected resources. This mode may be useful when a task needs knowledge of all relevant resources in the same task run.
  • Individual mode — In this mode, each selected resource results in its own dedicated event where the resource is represented in the event data. This mode may be useful when a task only needs to think about a single resource at a time.
processingMode
Read more
Platform support extended to (nearly) all Shopify webhook topics
new
The Mechanic platform has been updated to better track Shopify's expanding list of webhook topics. Our complement of supported topics will now be updated quarterly, as Shopify's latest stable Admin API release rolls ahead.
This update is a direct result of a question asked in our community Slack workspace. Thanks, loves!
❤️ ❤️
Event topics added:
  • shopify/channels/delete
  • shopify/customers_marketing_consent/update
  • shopify/domains/create
  • shopify/domains/destroy
  • shopify/domains/update
  • shopify/fulfillment_orders/cancellation_request_accepted
  • shopify/fulfillment_orders/cancellation_request_rejected
  • shopify/fulfillment_orders/cancellation_request_submitted
  • shopify/fulfillment_orders/cancelled
  • shopify/fulfillment_orders/fulfillment_request_accepted
  • shopify/fulfillment_orders/fulfillment_request_rejected
  • shopify/fulfillment_orders/fulfillment_request_submitted
  • shopify/fulfillment_orders/fulfillment_service_failed_to_complete
  • shopify/fulfillment_orders/hold_released
  • shopify/fulfillment_orders/line_items_prepared_for_local_delivery
  • shopify/fulfillment_orders/line_items_prepared_for_pickup
  • shopify/fulfillment_orders/moved
  • shopify/fulfillment_orders/order_routing_complete
  • shopify/fulfillment_orders/placed_on_hold
  • shopify/fulfillment_orders/rescheduled
  • shopify/fulfillment_orders/scheduled_fulfillment_order_ready
  • shopify/locales/create
  • shopify/locales/update
  • shopify/locations/activate
  • shopify/locations/deactivate
  • shopify/markets/create
  • shopify/markets/delete
  • shopify/markets/update
  • shopify/payment_schedules/due
  • shopify/payment_terms/create
  • shopify/payment_terms/delete
  • shopify/payment_terms/update
  • shopify/profiles/create
  • shopify/profiles/delete
  • shopify/profiles/update
  • shopify/returns/approve
  • shopify/returns/cancel
  • shopify/returns/close
  • shopify/returns/decline
  • shopify/returns/reopen
  • shopify/returns/request
  • shopify/reverse_deliveries/attach_deliverable
  • shopify/reverse_fulfillment_orders/dispose
  • shopify/segments/create
  • shopify/segments/delete
  • shopify/segments/update
  • shopify/tender_transactions/create
  • shopify/variants/in_stock
  • shopify/variants/out_of_stock
Event topics removed:
  • shopify/checkouts/paid — this topic is not available in any stable Shopify Admin API releases
Read more
Shopify event payloads now use version 2023-01
new
When preparing events to send to apps like Mechanic, Shopify uses resource representations from specific versions of their REST Admin API.
Effective immediately, Shopify events in Mechanic now use resource representations from version 2023-01 of the REST Admin API.
Shopify does not report any breaking changes for REST representations in this version.
Read more
New Liquid filter: sort_naturally
new
Mechanic now supports
sort_naturally
, an array filter which uses a human-friendly sort algorithm.
This addition complements Liquid's standard sorting filters (
sort
, for sorting with strict value comparisons;
sort_natural
, for sorting by case-insensitive string values).
Read more
Shopify event payloads now use version 2022-10
new
When preparing events to send to apps like Mechanic, Shopify uses resource representations from specific versions of their REST Admin API.
Effective immediately, Shopify events now use resource representations from version 2022-1- of the REST Admin API.
Shopify reports several breaking changes to REST representations for webhooks in this version, including:
  • The cancel endpoint on the Fulfillment API has been deprecated
  • Deprecated customer-related Order properties
  • Deprecated Order and LineItem properties
Note that version 2022-10 also includes new controls on protected customer data. Mechanic has been fully approved for all protected customer data, which means this breaking change does not generally affect Mechanic users. It
may
affect users who are using a custom Shopify Admin API access token, depending on their specific usage.
Read more
New HTTP action options: "follow_redirects", "proxy"
new
The HTTP action now supports two additional options:
  • "follow_redirects"
    — for controlling whether or not 3xx responses are automatically followed to the destination specified in the
    Location
    header (defaults to
    true
    )
  • "proxy"
    — for routing outbound requests through an HTTPS, HTTP, or SOCKS5 proxy (useful for APIs that require fixed client IP addresses)
Read more
Load More