Skip to content

148 trigger windmill - #149

Open
nicopace wants to merge 3 commits into
mainfrom
148-trigger-windmill
Open

148 trigger windmill#149
nicopace wants to merge 3 commits into
mainfrom
148-trigger-windmill

Conversation

@nicopace

@nicopace nicopace commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Closes #148

Written with assistance of Google Gemini, reviewed by me.

@nicopace
nicopace requested a review from rudokemper September 2, 2026 14:29

You can set scripts and flows to run on a set schedule, or automatically trigger them to run in the background whenever specific events happen in your other tools.

## Real-Time Syncing with KoboToolbox Webhooks

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Real-Time Syncing with KoboToolbox Webhooks
## Webhooks
### Real-Time Syncing with KoboToolbox Webhooks


## Real-Time Syncing with KoboToolbox Webhooks

When using KoboToolbox to collect data in the field, you don't need to manually run a script every time you want to pull down the newest form submissions. Instead, you can use **Webhooks** (*REST Services* in KoboToolbox) to automate the process.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link to KoboToolbox REST Services documentation


## Real-Time Syncing with KoboToolbox Webhooks

When using KoboToolbox to collect data in the field, you don't need to manually run a script every time you want to pull down the newest form submissions. Instead, you can use **Webhooks** (*REST Services* in KoboToolbox) to automate the process.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When using KoboToolbox to collect data in the field, you don't need to manually run a script every time you want to pull down the newest form submissions. Instead, you can use **Webhooks** (*REST Services* in KoboToolbox) to automate the process.
When using KoboToolbox to collect data in the field, you don't need to manually run a script, or rely on a schedule, every time you want to pull down the newest form submissions. Instead, you can use **Webhooks** (*REST Services* in KoboToolbox) to automate the process.


When using KoboToolbox to collect data in the field, you don't need to manually run a script every time you want to pull down the newest form submissions. Instead, you can use **Webhooks** (*REST Services* in KoboToolbox) to automate the process.

As soon as a surveyor submits a new record, KoboToolbox sends an automatic, instant message to your script. This immediately triggers your flow to run and process the new data. This ensures your datasets in Guardian Connector are updated in real-time, without any manual intervention.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
As soon as a surveyor submits a new record, KoboToolbox sends an automatic, instant message to your script. This immediately triggers your flow to run and process the new data. This ensures your datasets in Guardian Connector are updated in real-time, without any manual intervention.
As soon as a surveyor submits a new record, KoboToolbox automatically triggers your Windmill script to run and process the new data. This ensures your datasets in Guardian Connector are updated in real-time, without any manual intervention.


As soon as a surveyor submits a new record, KoboToolbox sends an automatic, instant message to your script. This immediately triggers your flow to run and process the new data. This ensures your datasets in Guardian Connector are updated in real-time, without any manual intervention.

*To set this up, you simply generate a unique Webhook URL for your script in the Hub, and paste it into the "REST Services" settings of your KoboToolbox project.*

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
*To set this up, you simply generate a unique Webhook URL for your script in the Hub, and paste it into the "REST Services" settings of your KoboToolbox project.*
*To set this up, you simply generate a unique Webhook URL for your script in the Windmill, and paste it into the "REST Services" settings of your KoboToolbox project.*

This is missing documentation. It is not just the URL. Also the token and Body must be pasted into the REST Services.

Please have Gemini read the documentation I wrote, or manually improve it yourself to guarantee accuracy.

:::

You can set scripts and flows to run on a set schedule, or automatically trigger them to run in the background whenever specific events happen in your other tools.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a section ## Scheduling, as this is the most common way that we trigger scripts.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And it should absolutely go before ## Webhooks

Comment on lines +23 to +31
## Other Ways to Automate Scripts

Beyond KoboToolbox, you can automate your workflows in a variety of ways depending on your organization's needs. Here are the primary methods available for running or triggering scripts:

* **[Schedule](https://www.windmill.dev/docs/core_concepts/scheduling):** Run a script automatically at a specific time or recurring interval.
* Example: Pulling data from a government agency every night at midnight.

* **[Webhooks](https://www.windmill.dev/docs/core_concepts/webhooks):** Trigger a script instantly when an external service sends an update.
* Example: updating dashboards when new submissions have been done on KoboToolbox.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Other Ways to Automate Scripts
Beyond KoboToolbox, you can automate your workflows in a variety of ways depending on your organization's needs. Here are the primary methods available for running or triggering scripts:
* **[Schedule](https://www.windmill.dev/docs/core_concepts/scheduling):** Run a script automatically at a specific time or recurring interval.
* Example: Pulling data from a government agency every night at midnight.
* **[Webhooks](https://www.windmill.dev/docs/core_concepts/webhooks):** Trigger a script instantly when an external service sends an update.
* Example: updating dashboards when new submissions have been done on KoboToolbox.
## Other Ways to Trigger Scripts

And add * **Manual Runs**:

@rudokemper

Copy link
Copy Markdown
Member

In addition to my review comments, please also update your PR title to be more descriptive.

When squashing and merging in this (and any of our GC) repos, the PR message will become the commit message. So the PR title matters for understanding logs and diffing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

How to trigger actions on Windmill

2 participants