Lexifina Webhooks

generated: '2026-11-11'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://app.lexifina.com/api/v1/docs#/webhooks/webhooks.webhook.test
sources:
- https://app.lexifina.com/api/v1/docs#/webhooks/webhooks.webhook.test
- https://lexifina.com/api/webhooks
- https://lexifina.com/api/reference/webhook_endpoints.list
- https://lexifina.com/api/reference/webhook_endpoints.create
description: Lexifina webhooks deliver JSON event objects. Each delivery includes required headers `webhook-id`, `webhook-timestamp`, and `webhook-signature`
  (HMAC‑SHA256 of "{webhook-id}.{webhook-timestamp}.{body}" with the endpoint secret). The endpoint must reject attempts older than five minutes.
  A `2XX` response is considered successful; any other response or no response within 10 seconds triggers a retry for up to 72 hours.
events:
- event: comparison.completed
  description: A comparison you started finished.
- event: comparison.failed
  description: A comparison you started finished.
- event: conversion.completed
  description: Every file of a conversion job has been converted or has failed. Retrieve the job, then download each result.
- event: conversion.failed
  description: Every file of a conversion job has been converted or has failed. Retrieve the job, then download each result.
- event: document.processed
  description: Background structure and clause analysis of a document version finished.
- event: document.processing_failed
  description: Background structure and clause analysis of a document version finished.
- event: envelope.completed
  description: A signer signed or declined, or every signer has signed.
- event: envelope.declined
  description: A signer signed or declined, or every signer has signed.
- event: envelope.signed
  description: A signer signed or declined, or every signer has signed.
- event: run.cancelled
  description: A run finished. Retrieve it for its answer, output and proposed changes.
- event: run.completed
  description: A run finished. Retrieve it for its answer, output and proposed changes.
- event: run.failed
  description: A run finished. Retrieve it for its answer, output and proposed changes.
- event: run.output_ready
  description: A run's structured output (output_schema) is ready, or could not be extracted.
- event: run.proposals_ready
  description: A completed run proposed changes.
- event: run.requires_input
  description: A run, or a subagent under it, is waiting for an answer.
- event: webhook.test
  description: Sent when you test an endpoint.
- event: workflow.intervention_required
  description: A workflow run is waiting for a person to approve a step.
docs: https://app.lexifina.com/api/v1/docs#/webhooks/webhooks.webhook.test