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 
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.