triggers

Configure Windmill trigger YAML files for HTTP, Kafka, NATS, MQTT, and other event sources.

1|Updated Aug 3, 2026
One-click install
npx skills add https://github.com/vpzed-dev/smithy --skill triggers-vpzed-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triggers
Source: https://github.com/vpzed-dev/smithy/tree/main/windmill/local-dev/.agents/skills/triggers
Command: npx skills add https://github.com/vpzed-dev/smithy --skill triggers-vpzed-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Configuring Windmill triggers requires knowing the exact YAML schema for each trigger type, and mistakes in required fields or naming conventions cause silent deployment failures. This Skill provides the complete schemas and payload contracts so trigger configuration files are correct on the first attempt. ## Core Features & Use Cases - Full trigger schemas: Provides validated YAML schemas for HTTP, WebSocket, Kafka, NATS, Postgres CDC, MQTT, AMQP, SQS, and email triggers, including required fields, enums, and retry configuration. - Email trigger payload handling: Documents the parsed_email/raw_email payload structure, S3-backed attachment access via the wmill SDK, and +key=value extra arguments. - Safe deployment guidance: Distinguishes destructive wmill sync push from safe wmill sync pull operations so remote state is never mutated unintentionally. - Use Case: A developer needs a Kafka consumer that invokes a flow whenever messages arrive on specific topics. The Skill supplies the exact *.kafka_trigger.yaml file with kafka_resource_path, group_id, topics, filters, and retry policy. ## Quick Start Create a Windmill HTTP trigger YAML file that routes POST requests on api/orders to my order-processing script with API key authentication.

Frequently Asked Questions about triggers

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

FAQPage Schema
How do I create a Windmill HTTP trigger YAML file?▼

Create a file named path.http_trigger.yaml with required fields script_path, is_flow, route_path, request_type, authentication_method, http_method, is_static_website, workspaced_route, wrap_body, and raw_string. The route_path must not start with a slash.

How to configure a Kafka trigger in Windmill?▼

Define a *.kafka_trigger.yaml file with kafka_resource_path, group_id, topics, and filters as required fields. You can also set auto_offset_reset to latest or earliest and disable auto_commit to commit offsets manually.

What naming convention do Windmill trigger files use?▼

Trigger files follow the pattern {path}.{trigger_type}_trigger.yaml, such as u/user/webhook.http_trigger.yaml or f/data/kafka_consumer.kafka_trigger.yaml. Supported types include http, websocket, kafka, nats, postgres, mqtt, amqp, sqs, and email.

How do Windmill email trigger attachments work?▼

Binary attachments are uploaded to the workspace S3 bucket and appear as { s3: path } objects in parsed_email.attachments. Read them with wmill.loadS3File in TypeScript or wmill.load_s3_file in Python; without S3 configured, the body falls back to a placeholder string.

Is it safe to run wmill sync push when testing triggers?▼

No, wmill sync push deploys local changes and can destructively modify remote state, so only run it when explicitly asked to deploy. Use wmill sync pull or sync pull --dry-run for safe operations that never mutate remote state.

Does Windmill Postgres trigger support change data capture?▼

Yes, the *.postgres_trigger.yaml schema supports logical replication CDC through required postgres_resource_path, publication_name, and replication_slot_name fields. It subscribes to a PostgreSQL publication and invokes the configured script or flow on changes.