Skip to main content

​
What are Triggers?

Triggers automatically execute your Projects in response to events, without manual intervention. Instead of clicking “Execute” every time, set up Triggers to run your Projects when specific conditions are met.

​
Types of Triggers

​
Webhook Triggers

Execute when an HTTP request hits your webhook endpoint. Use cases:
  • Payment notifications (Stripe, PayPal)
  • GitHub events (push, PR, issue)
  • Form submissions
  • Third-party service events
Setup:
  1. Go to Project → Triggers
  2. Click Add Trigger → Webhook
  3. Configure:
    • Path: /webhook/payment-received
    • Authentication: API key or HMAC signature
    • Payload transformation (if needed)
  4. Save → Get webhook URL
  5. Register URL with external service
Example URL: 
https://api.triform.ai/v1/webhooks/your-org/payment-received
Incoming webhook: 
POST /v1/webhooks/your-org/payment-received
{
  "event": "payment.success",
  "amount": 99.99,
  "customer_id": "cust_123"
}
Your Project receives: 
{
  "event_type": "payment.success",
  "amount": 99.99,
  "customer_id": "cust_123",
  "received_at": "2025-10-01T10:30:00Z"
}

​
Schedule Triggers

Execute at specific times or intervals. Use cases:
  • Daily reports
  • Periodic data sync
  • Cleanup jobs
  • Monitoring checks
Setup:
  1. Go to Project → Triggers
  2. Click Add Trigger → Schedule
  3. Configure schedule:
    • Cron expression: 0 6 * * * (daily at 6 AM)
    • Interval: Every 15 minutes
    • One-time: Specific date/time
  4. Set timezone
  5. Define payload (static or dynamic)
  6. Save
Schedule types:
TypeExampleDescription
Cron0 6 * * *Daily at 6 AM UTC
IntervalEvery 15 minutesRepeating interval
HourlyEvery hour at :00Top of each hour
DailyDaily at 9:00 AMSpecific time daily
WeeklyEvery Monday at 8:00 AMSpecific day/time weekly
Monthly1st of month at 00:00Specific day each month
One-time2025-10-15 14:00:00Single execution
Cron expression format: 
* * * * *
│ │ │ │ │
│ │ │ │ └─── Day of week (0-7, 0=Sunday)
│ │ │ └───── Month (1-12)
│ │ └─────── Day of month (1-31)
│ └───────── Hour (0-23)
└─────────── Minute (0-59)
Common patterns:
  • 0 * * * * — Every hour
  • */15 * * * * — Every 15 minutes
  • 0 9 * * 1-5 — Weekdays at 9 AM
  • 0 0 1 * * — First of each month

​
Manual Triggers

Execute via Execution button. Use cases:
  • On-demand processing
  • Admin actions
  • Testing
  • User-initiated workflows

​
Viewing Triggers

  1. Go to Project → Executions
  2. See list of all triggers:
    • Type (webhook, schedule)

​
Editing Triggers

  1. Select trigger from list
  2. Click Edit
  3. Modify configuration
  4. Save → Changes take effect immediately
Note: Schedule changes apply to future executions, not currently running ones.

​
Deleting Triggers

Permanently remove a trigger:
  1. Select trigger
  2. Click Delete
  3. Confirm
  4. Trigger is removed
Warning: Cannot be undone. Webhook URLs will stop working.

​
Trigger configuration

​
Payload

Define what data the triggered execution receives. Static payload: 
{
  "source": "scheduled_job",
  "timestamp": "{{now}}"
}
Dynamic payload from webhook: 
{
  "event_type": "{{webhook.event}}",
  "data": "{{webhook.body}}",
  "headers": "{{webhook.headers}}"
}
Using variables: 
{
  "api_key": "{{global.API_KEY}}",
  "environment": "{{global.ENV}}"
}

​
Timeout

Set maximum execution time:
  • Default: 60 seconds
  • Max: 15 minutes (Pro), 60 minutes (Enterprise)
If timeout reached:
  • Execution is canceled
  • Error logged
  • Retry policy applies (if configured)

​
Webhook authentication

Secure your webhook endpoints.

​
API Key

Require API key in header: 
curl -X POST https://api.triform.ai/v1/webhooks/your-endpoint \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data": "value"}'
Configuration:
  1. Enable API key authentication
  2. Provide key to webhook sender
  3. Triform validates before execution

​
Common patterns

​
Pattern 1: Webhook → Process → Notify

Webhook receives event
  → Validate and transform
  → Process data
  → Send notification
Example: Payment received → Update database → Email customer

​
Pattern 2: Schedule → Fetch → Process → Store

Daily at 6 AM
  → Fetch data from APIs
  → Process and analyze
  → Store results
Example: Daily report generation

​
Pattern 3: Event chain

Project A completes
  → Triggers Project B
  → Triggers Project C
Example: Onboarding flow: Create account → Send welcome → Provision services

​
Pattern 4: Error handling

Project fails
  → Event trigger fires
  → Error logger Project executes
  → Alert sent to team
Example: Automated incident response

​
Troubleshooting

Problem: Webhook not triggering
Solution: Check URL is correct, authentication is valid, check logs for rejected requests Problem: Schedule not running
Solution: Verify cron expression, check timezone, ensure trigger is not paused Problem: Trigger fires but execution fails
Solution: Check payload format, verify required fields, review execution logs

​
Next steps

Continue exploring the documentation to learn about Executions and webhook configuration.
⌘I