Choosing a Trigger
A trigger is your automation's starting whistle — nothing happens until it blows. It's always the first block on the canvas; click it to open the trigger settings and pick one of four ways to start a run.
Which trigger do I need?
| You want to... | Use |
|---|---|
| Run it yourself, whenever you decide | Manual |
| Run it every morning / hour / Monday | Schedule |
| Start it the moment something happens in HubSpot, Stripe, Shopify, GitHub… | App trigger |
| Let your own system or website start it by calling a private address | Webhook |
Click a mode to see its setup, exactly as the trigger block shows it:
Manual — "run when I press the button"
The simplest start: a Run button. Good for processes you want to control by hand — a monthly report you trigger when the numbers are ready, or a cleanup you run on demand.
You can also give a manual automation a saved input — a small piece of starting data (for example, a customer name or a date range). When you press Run, a window lets you review and change that input for this one run. Active manual automations can also be started by your agents and by Nirvai Connect, which makes them reusable routines.
Schedule — "run this on a timer"
An alarm clock for your automation: pick days, a time, and how often. When you set it up, Nirvai shows the next upcoming runs so you can confirm the timing reads the way you intended.
Webhook — "my own system starts it"
Your automation gets a private web address. When another system sends information to that address (including a private key so Nirvai knows it's really you), a run starts with that information as its input. Use this for your own website, forms, or internal tools.
App trigger — "start when something happens in another app"
The newest and most powerful option: subscribe your automation to real events in the apps you already use. Pick from a gallery of ready-made triggers — New deal in HubSpot, Order created in Shopify, Payment succeeded in Stripe, Issue opened in GitHub, and many more — connect the app, and the automation runs the moment the event happens, carrying the event's data with it.
App triggers have their own page: App Triggers.
The trigger data is your raw material
Whatever starts the run also feeds it. A schedule starts with a clean slate; a manual run carries your input; webhooks and app triggers carry the information the outside world sent — the deal, the order, the message. Every later step can reach that data through {{trigger...}} variables (Data Between Steps).
Changing your trigger later
Click the trigger block anytime to switch modes — a scheduled automation can become manual, a manual one can gain an app trigger. Your blocks and connections stay untouched; only the starting whistle changes.
Troubleshooting
| Problem | Fix |
|---|---|
| My scheduled automation didn't run | Check that the automation is activated (the switch in the toolbar) — a draft never runs on its own. |
| My webhook runs don't start | Confirm the sender uses your exact private address and includes the private key. |
| I picked an app trigger but nothing happens | App triggers need to be activated and the app connected — see App Triggers. |
| I need to test without waiting for the real event | Every trigger has a test mode — see Testing & Runs. |
What's next
If you chose an app trigger, continue to App Triggers. Otherwise, jump to Building on the Canvas.