Webhooks

Get notified when events happen in PILOT.

Planned Events

The following webhook events are planned for the initial release:

Event	Description
capture.created	A new capture was received and classified
capture.routed	A capture was manually routed to a tier
task.created	A new task was created (manually or from capture)
task.completed	A task was marked as complete
decision.created	A new decision was logged
email.triaged	New email triage results are available
email.delegated	An email was delegated to a team member
briefing.ready	Daily or weekly briefing has been generated
relationship.alert	A relationship health threshold was crossed
entity.merged	Two entities were merged in the graph

Planned Payload Format

Each webhook delivery will include:

{
  "id": "evt_abc123",
  "type": "task.completed",
  "created_at": "2026-04-05T14:30:00Z",
  "data": {
    "task_id": "tsk_xyz789",
    "title": "Review Q3 proposal",
    "completed_at": "2026-04-05T14:30:00Z"
  }
}

Planned Security

• Each webhook endpoint will have a unique signing secret
• Every delivery includes a X-Pilot-Signature header (HMAC-SHA256)
• Delivery retries with exponential backoff (3 attempts over 24 hours)
• Delivery logs viewable in the PILOT dashboard

Get Notified

Want to know when webhooks launch? Join the PILOT waitlist or contact us at support@withpilot.ai.

In the meantime, you can poll the API endpoints to check for changes. The GET /api/v1/briefing and GET /api/v1/email/triage endpoints are good starting points for periodic polling.