Webhook events

Agent Payments versioned Webhook envelope, event types, and payload field reference.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Versioned envelope for Agent Payments webhooks. Persist and deduplicate by id before processing data.

id*string

Stable event ID used for deduplication.

type*string

Agent Payments event type identifier.

version*string

Payload schema version. Dispatch by type and version together.

occurred_at*string

ISO 8601 timestamp at which the event occurred.

data*||

Intent lifecycle events use AgentPaymentIntentEventData; Agent and organization pause events use their dedicated payloads.

Example Requests

Versioned envelope for Agent Payments webhooks. Persist and deduplicate by id before processing data.

POST/agent_payment_event