Skip to Content
DispatchersTriggers

Dispatcher Triggers

When Dispatchers Run

Dispatchers evaluate automatically when:

EventDescription
Order createdA new order is synced or created via API
Order updatedAn order’s status, tags, or data changes
Manual triggerYou explicitly run dispatchers on selected orders

Automatic Evaluation

When an order is created or updated, all enabled dispatchers are evaluated in priority order. This happens:

  • After a bridge sync imports new orders
  • After a webhook creates/updates an order
  • After an API call modifies an order
  • After an operation changes order data

Manual Trigger

Run dispatchers on demand for orders that may have been missed:

Portal

Go to Dispatchers and click Run Now on any dispatcher to evaluate it against all matching orders.

API

POST /api/dispatchers/:id/run

Or dispatch on specific orders:

POST /api/dispatchers/:id/run
Content-Type: application/json
 
{
  "orderIds": ["uuid-1", "uuid-2"]
}

Preventing Loops

Dispatchers don’t re-trigger on changes they themselves make. This prevents infinite loops where a dispatcher’s action triggers another evaluation.

ConfigAssignments