triggers

Configure Windmill trigger YAML files for email, webhook, Kafka, and Postgres events.

Updated May 28, 2026
One-click install
npx skills add https://github.com/kma-core/windmill --skill triggers-kma-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triggers
Source: https://github.com/kma-core/windmill/tree/main/system_prompts/auto-generated/skills/triggers
Command: npx skills add https://github.com/kma-core/windmill --skill triggers-kma-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up event-driven automation in Windmill requires correctly structured trigger configuration files, and mistakes in naming patterns, payload handling, or attachment processing cause silent failures. This Skill provides the exact conventions and payload schemas needed to wire external events to scripts and flows. ## Core Features & Use Cases - Trigger File Conventions: Defines the {path}.{trigger_type}_trigger.yaml naming pattern for HTTP, Kafka, Postgres CDC, and email triggers. - Email Trigger Configuration: Covers local-part reservation, workspace namespacing, +key=value extra arguments, and preprocessor event wrapping. - Attachment & Payload Handling: Explains how binary attachments and large raw emails are stored as S3 objects and read via the wmill SDK. - Use Case: Route inbound order emails to a flow by creating f/inbound/orders.email_trigger.yaml, then parse attachments in the script with wmill.load_s3_file. ## Quick Start Create an email trigger configuration file for my Windmill workspace that routes incoming order emails to my processing flow.

Frequently Asked Questions about triggers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an email trigger in Windmill?

Create a file named `{path}.email_trigger.yaml` in your workspace, such as `f/inbound/orders.email_trigger.yaml`. Emails sent to the configured local-part at your Windmill email domain are routed to the linked script or flow.

How to read email attachments in a Windmill script?

Attachments arrive as S3 objects in `parsed_email.attachments[i].body`. Use `wmill.loadS3File()` in TypeScript or `wmill.load_s3_file()` in Python to fetch the bytes from the workspace S3 bucket.

What naming pattern do Windmill trigger files use?

Trigger files follow the pattern `{path}.{trigger_type}_trigger.yaml`, for example `u/user/webhook.http_trigger.yaml` or `f/data/kafka_consumer.kafka_trigger.yaml`. The trigger type segment determines the trigger kind.

Why is my Windmill email attachment body a string instead of a file?

When the workspace has no S3 resource configured, attachment bodies fall back to a placeholder string. Configure object storage in Workspace Settings, and note the server must be built with the parquet feature.

How do I deploy Windmill trigger configurations?

Run `wmill sync push` to push local trigger configuration files to your Windmill instance, and `wmill sync pull` to retrieve existing triggers. These commands are run manually by the user after writing the files.