Agentaos Ai Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.agentaos.ai/connect/webhooks.md
sources:
- https://docs.agentaos.ai/connect/webhooks.md
- https://docs.agentaos.ai/payments/webhooks.md
- https://docs.agentaos.ai/webhooks/events.md
- https://docs.agentaos.ai/sdk/pay-webhooks.md
description: AgentaOS provides a single webhook endpoint that receives events for all businesses you manage, each payload signed with an HMAC‑SHA256
  signature.
events:
- event: checkout.session.completed
  description: Fires when a buyer pays a checkout by card, bank transfer or stablecoin, or when a free trial starts or a renewal succeeds.
- event: checkout.session.bank_transfer_pending
  description: Fires when a buyer chooses bank transfer on a checkout and receives the bank details.
- event: subscription.created
  description: Fires when a subscription becomes active or trialing for the first time.
- event: subscription.renewed
  description: Fires when a renewal charge succeeds, including credits that pay the renewal.
- event: subscription.payment_failed
  description: Fires when a renewal charge fails and the subscription status becomes past_due or unpaid.
- event: subscription.updated
  description: Fires on scheduled cancel, resume, upgrade, scheduled downgrade, or downgrade revert.
- event: subscription.canceled
  description: Fires when a subscription status becomes canceled.
- event: dispute.created
  description: Fires when AgentaOS finds a new dispute on one of your sales.
- event: dispute.closed
  description: Fires when a dispute closes in your favor or a bank inquiry closes without a chargeback.
- event: send.completed
  description: Fires when an outbound stablecoin send you started is confirmed.
- event: send.failed
  description: Fires when an outbound stablecoin send you started fails.
- event: account.updated
  description: Fires when a business's verification changes in live mode.
- event: webhook.test
  description: Fires when you click “Send test event” in the webhook settings.
delivery:
  signature: HMAC‑SHA256 using the signing secret (whsec_…) and the header `X-AgentaOS-Signature` formatted as `t=<timestamp>,v1=<hex>`
  retries: If the endpoint does not return a 2xx response, AgentaOS retries with exponential backoff up to a total of 3 attempts, then marks the
    event as failed.
docs: https://docs.agentaos.ai/connect/webhooks.md