Relaystation Ai Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://relaystation.ai/docs/webhooks
sources:
- https://relaystation.ai/docs/webhooks
description: Relaystation outbound webhooks deliver events about batons, e‑sign envelopes, ID verification runs, async jobs and bridge asks.
events:
- event: baton.written
  description: Fires when a write — an append or an overwrite — succeeds.
- event: token.used
  description: Fires when a token is used for a read or a write.
- event: token.exhausted
  description: Fires when a token hits its read or write cap.
- event: pass.all_tokens_consumed
  description: Fires when every recipient of a PASS baton has picked it up.
- event: envelope.sent
  description: E‑sign event that fires when an envelope is sent.
- event: envelope.viewed
  description: E‑sign event that fires when an envelope is viewed.
- event: envelope.signed
  description: E‑sign event that fires when a recipient signs the envelope.
- event: envelope.completed
  description: E‑sign event that fires when everyone has signed and the signed document is ready.
- event: envelope.rejected
  description: E‑sign event that fires when an envelope is rejected.
- event: envelope.expired
  description: E‑sign event that fires when an envelope expires.
- event: envelope.cancelled
  description: E‑sign event that fires when an envelope is cancelled.
- event: verification.started
  description: ID‑verification event that fires when a verification run starts.
- event: verification.document_processed
  description: ID‑verification event that fires when the document has been processed.
- event: verification.age_check
  description: ID‑verification event that fires when the age check is performed.
- event: verification.manual_review
  description: ID‑verification event that fires when a manual review is required.
- event: verification.completed
  description: ID‑verification event that fires when the verification run completes successfully.
- event: verification.failed
  description: ID‑verification event that fires when the verification run fails.
- event: verification.expired
  description: ID‑verification event that fires when the verification run expires.
- event: job.completed
  description: Fires when an async job reaches a terminal state (succeeded, failed, or expired).
- event: bridge.ask.replied
  description: Fires when a bridge ask flow receives a reply.
delivery:
  signature: 'Deliveries are signed with an X-Relaystation-Signature: sha256=<hex> header – an HMAC‑SHA256 over ${timestamp}.${rawBody} using
    the secret returned when the webhook was created.'
  retries: Failed deliveries are retried with exponential backoff; a continuously failing endpoint is eventually disabled.
docs: https://relaystation.ai/docs/webhooks