Triggers
Triggers are the starting point for every automation in Ventryx. They detect a condition — an event, a schedule, a metric threshold, or an incoming webhook — and kick off the configured workflow or action.
Trigger types
| Type | When it fires | Example |
|---|---|---|
| Event | A platform event matches the configured type | user.registered, order.placed |
| Schedule | A cron expression evaluates to true | Every weekday at 09:00 |
| Webhook | An inbound HTTP POST arrives at the trigger URL | GitHub push event |
| Metric threshold | A metric crosses a configured value | Error rate > 5% |
| Manual | Triggered explicitly via API, CLI, or dashboard | Test run, ad-hoc execution |
Event triggers
Subscribe to any platform event type, or use a wildcard to match a namespace:
{
"trigger": {
"type": "event",
"event": "order.*"
}
}
This fires for order.placed, order.cancelled, order.refunded, and any other order.* event type.
Schedule triggers (cron)
{
"trigger": {
"type": "schedule",
"cron": "0 9 * * 1-5",
"timezone": "America/New_York"
}
}
Cron expressions follow standard 5-field syntax. All times are evaluated in the specified timezone.
Webhook triggers
Each webhook trigger gets a unique inbound URL. POST any JSON payload to that URL and the trigger fires immediately:
POST https://hooks.ventryx.io/t/trg_01HXYZ
Content-Type: application/json
{ "type": "deploy.completed", "env": "production", "version": "v2.4.1" }