All event topics
Every task needs at least one event topic to "listen" for – when an event with a matching topic occurs, the task is run.
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
- Every 15 minutes:
mechanic/scheduler/15min
- Every 20 minutes:
mechanic/scheduler/20min
- Every 30 minutes:
mechanic/scheduler/30min
- 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
Disputes
- Created:
shopify/disputes/create
- Updated:
shopify/disputes/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
- Edited:
shopify/orders/edited
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