BillixDOCS
Background AgentsTriggers

Agent Triggers

Control when and how your agents run

1 min read
Documentation

Triggers determine when your agent runs. Choose the right trigger type for your automation needs.

Trigger Types

Choosing a Trigger Type

TriggerBest ForExample
ScheduleRegular, time-based tasksDaily email digest at 8 AM
WebhookExternal service integrationRun when Stripe payment received
EventReact to changes in connected appsNew GitHub issue created
ManualOn-demand tasksGenerate report when needed

Quick Comparison

Schedule Triggers

Run at specific times you define.

  • Daily, weekly, monthly, or custom intervals
  • Specific times (9:00 AM, midnight, etc.)
  • Timezone-aware
  • Most common trigger type

Example: "Run every weekday at 8:00 AM"

Webhook Triggers

Run when called via HTTP request.

  • Get a unique URL for your agent
  • Call from any external service
  • Pass data in the request
  • Great for integrating with other tools

Example: "Run when Zapier sends a request"

Event Triggers

Run when something happens in a connected service.

  • Powered by Composio integrations
  • React to real events (new email, new file, etc.)
  • No polling needed
  • Real-time responsiveness

Example: "Run when a new email arrives"

Manual Triggers

Run only when you explicitly start the agent.

  • Click "Run Now" in the UI
  • No automatic execution
  • Good for testing or on-demand tasks

Example: "Run when I want to generate a report"

Multiple Triggers

You can add multiple triggers to a single agent:

  • Schedule + Manual (runs daily AND when you click "Run Now")
  • Multiple schedules (runs at 8 AM AND at 5 PM)
  • Webhook + Schedule (runs on schedule AND when called externally)

Trigger Limits

PlanScheduled AgentsWebhook AgentsEvent Agents
Free10105
ProUnlimitedUnlimitedUnlimited

Common Configurations

Daily Task

Trigger: Schedule
Frequency: Daily
Time: 8:00 AM
Timezone: Your local timezone

Workday Task

Trigger: Schedule
Frequency: Weekly
Days: Monday, Tuesday, Wednesday, Thursday, Friday
Time: 9:00 AM

Real-time Response

Trigger: Event
Service: Gmail
Event: New email received
Filter: From important contacts

External Integration

Trigger: Webhook
URL: https://billix.io/api/agents/webhook/abc123
Method: POST
Authentication: API key header

Next Steps

Learn more about each trigger type:

Was this page helpful? Let us know!

Report an issue

On this page