All event topics
Every task needs at least one event topic to "listen" for – when an event with a matching topic occurs, the task runs.
Mechanic has many events that it can work with, giving you many options as you get creative with your shop's automation. :) We've organized these by domain and subject – the first two components of an event topic.
- Mechanic
Generated by Mechanic itself. Supports scheduling, events initiated from within the Mechanic app, incoming email, and the results of performed actions. - User
You get to emit these yourself, using webhooks or the "event" action. - Shopify
These correspond one-to-one with Shopify webhooks topics.
Third-party integrations
Mechanic
These events are generated by Mechanic.
Actions
Subscribe to these actions to act upon the results of actions, as the they happen. Read more: Responding to action results
- Perform:
mechanic/actions/perform
Emails
You can receive email with Mechanic, too! If your Shopify account is at fantastic.myshopify.com, try emailing yourself at fantastic@mail.usemechanic.com.
- Received:
mechanic/emails/received
Scheduler
These events run at regular intervals. In some cases, they may run a minute or two off from the exact time specified.
- Every 10 minutes:
mechanic/scheduler/10min - Hourly:
mechanic/scheduler/hourly - Daily:
mechanic/scheduler/daily(midnight, in the shop's local timezone) - Weekly, per weekday (runs midnight, at the beginning of the day, in the shop's local timezone):
mechanic/scheduler/sunday
mechanic/scheduler/monday
mechanic/scheduler/tuesday
mechanic/scheduler/wednesday
mechanic/scheduler/thursday
mechanic/scheduler/friday
mechanic/scheduler/saturday
This is a good time to note that all event subscriptions can be combined with a time delay, as in these examples:
mechanic/scheduler/daily+6.hours(runs at 6am)mechanic/scheduler/daily+20.hours(runs at 8pm)mechanic/scheduler/daily+150.minutes(runs at 2:30am)
User
These events describe runs that the user can trigger from within the Mechanic application interface.
- Text input:
mechanic/user/text - Simple trigger:
mechanic/user/trigger
User
Yes, you get to generate events too!
User event topics always start with user/ , but the rest is up to the task script. They always follow the same three-part form as every other event topic.
Learn about triggering user events with the "event" action.
Shopify
These events are generated by Shopify.
Cart
- Create:
shopify/carts/create - Update:
shopify/carts/update
Checkout
- Create:
shopify/checkouts/create - Update:
shopify/checkouts/update - Paid:
shopify/checkouts/paid - Delete:
shopify/checkouts/delete
Collections
- Create:
shopify/collections/create - Update:
shopify/collections/update - Delete:
shopify/collections/delete
Customer saved searches
Note: Shopify calls these "customer saved searches", but under the hood they still refer to them as "customer groups".
- Create:
shopify/customer_groups/create - Update:
shopify/customer_groups/update - Delete:
shopify/customer_groups/delete
Customers
- Created:
shopify/customers/create - Deleted:
shopify/customers/delete - Disabled:
shopify/customers/disable - Enabled:
shopify/customers/enable - Updated:
shopify/customers/update
Draft orders
- Created:
shopify/draft_orders/create - Deleted:
shopify/draft_orders/delete - Updated:
shopify/draft_orders/update
Fulfillment events
- Created:
shopify/fulfillment_events/create - Deleted:
shopify/fulfillment_events/delete
Fulfillments
- Created:
shopify/fulfillments/create - Updated:
shopify/fulfillments/update
Inventory Items
- Created:
shopify/inventory_items/create - Updated:
shopify/inventory_items/update - Deleted:
shopify/inventory_items/delete
Inventory Levels
- Connected:
shopify/inventory_levels/connect - Updated:
shopify/inventory_levels/update - Disconnected:
shopify/inventory_levels/disconnect
Locations
- Created:
shopify/locations/create - Updated:
shopify/locations/update - Deleted:
shopify/locations/delete
Order transactions
- Created:
shopify/order_transactions/create
Orders
- Cancelled:
shopify/orders/cancelled - Created:
shopify/orders/create - Deleted:
shopify/orders/delete - Fulfilled:
shopify/orders/fulfilled - Paid:
shopify/orders/paid - Partially fulfilled:
shopify/orders/partially_fulfilled - Updated:
shopify/orders/updated
Products
- Created:
shopify/products/create - Deleted:
shopify/products/delete - Updated:
shopify/products/update
Refunds
- Created:
shopify/refunds/create
Shop
- Updated:
shopify/shop/update
Themes
- Created:
shopify/themes/create - Deleted:
shopify/themes/delete - Published:
shopify/themes/publish - Updated:
shopify/themes/update
Third-party integrations
Judge.me
- Review created:
judgeme/review/created