Building Agents
Deep dive into agent configuration—triggers, workflow steps, execution, and monitoring.
Triggers
A trigger defines when your agent runs. Akkio supports two primary trigger types:
Schedule (Cron)
Run your agent on a recurring schedule—every hour, daily, weekly, or custom intervals.
Natural Language Support
0 9 * * *0 10 * * 10 * * * *Webhook
Trigger your agent via an HTTP request. Perfect for event-driven automations from external systems or custom API calls.
# Webhook Endpoint
POST https://akkio.io/api/webhooks/<agent_id>
# Authorization
Authorization: Bearer <webhook_token>
The request body is passed to your agent as contextual data, available via the `payload` variable.
Workflow Steps
Workflow steps are the actions your agent performs in sequence. Each step connects to an integration and executes a specific capability.
Sequence Visualization
slack_send_messagePost to #standup channel
linear_create_issueCreate follow-up task
gmail_send_emailEmail stakeholders
Step Limits
Free plans allow up to 5 steps per agent. Pro plans offer unlimited multi-step sequences.
Runs & Execution
A Run is a single execution of your agent. Every time a trigger is fired, Akkio creates a lifecycle run.
Agent Settings
Active / Inactive
Toggle whether your agent responds to automatic triggers.
Configuration
Modify agent name, triggers, and workflow steps at any time.
Lifecycle Control
Deactivate, archive, or permanently delete agents.