Webhooks Overview
Talonic webhooks deliver real-time event notifications to your server. Every delivery is signed with HMAC-SHA256 for verification and follows an automatic retry policy.
Guides
Event Catalog
All webhook event types and their payloads.
Delivery Format
HTTP delivery format, headers, and payload structure.
Signature Verification
Verify HMAC-SHA256 signatures with X-Talonic-Signature.
Retry Policy
Automatic retry schedule and failure handling.
Setting up webhooks
Configure webhook URLs per source or globally in the Talonic platform. Events fire when documents are processed through the four-phase pipeline, when corrections are submitted, and when jobs change status. Verify every delivery using the X-Talonic-Signature header. See authentication for access setup.
Frequently asked questions
What file formats does the Talonic API support?+
PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, XLSM, PNG, JPG, JPEG, GIF, WEBP, TXT, MD, HTML, XML, JSON, EML, CSV, MSG, BMP, and ZIP archives.
How does authentication work?+
All API requests require a Bearer token in the Authorization header. API keys carry the tlnc_ prefix and are scoped to a source. Create and manage keys from Settings → API Keys.
What schema formats are supported?+
Three formats: JSON Schema (full control), simplified fields (recommended), and flat key-type maps (quick prototyping). Supported types: string, number, integer, boolean, date, array, object, enum.
What are the rate limits?+
Per-key rate limits: 100 req/s extraction, 1,000 req/s read, 200 req/s write. Rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included on every response.