Skip to main content

Triggers

Triggers enable agents to execute in response to external events via webhooks. When something happens in another system, it can automatically invoke your agent.

For full documentation, see Triggers (Full Guide).

Quick Overview​

Why Triggers?​

Connect your agents to the outside world:

  • Form submissions: Process new leads instantly
  • Payment events: Handle Stripe webhooks
  • CI/CD: Run agents on deployment events
  • Custom integrations: Any system that can send HTTP requests

How Triggers Work​

External System ──HTTP POST──▶ Trigger Webhook ──▶ Agent Execution

Basic Example​

const trigger = await client.triggers.create({
  name: 'New Lead Processor',
  description: 'Process new leads from website form',
  targetType: 'agent',
  targetId: 'lead-agent-123'
});

console.log(trigger.webhookUrl);
// https://api.deeployd.com/triggers/abc123

With Signature Verification​

const trigger = await client.triggers.create({
  name: 'Stripe Webhook',
  targetType: 'agent',
  targetId: 'payment-agent',
  requireSignature: true
});

Full documentation: Triggers (Complete Guide)