Webhooks
Configuration and usage of webhooks to receive real-time notifications
Webhooks
Webhooks allow you to receive real-time notifications about events that occur in your Docutray account. When you configure a webhook, Docutray will send an HTTP POST request to the URL you specify each time an event you've subscribed to occurs.
Available Webhook Types
Docutray supports three types of webhooks, each designed for different use cases:
Conversion Webhooks
Receive notifications during document processing when using a specific document type to extract structured data.
Identification Webhooks
Receive notifications during the automatic document type identification process.
Steps Webhooks
Receive notifications during the execution of individual steps in document processing workflows.
Configuration Guides
Initial Setup
Learn how to configure and manage webhooks in your Docutray account.
Security and Verification
Protect your endpoints with HMAC signature verification and replay attack prevention.
Implementation Examples
Sample code in Node.js and Python to implement webhooks.
Key Features
- Real-time notifications: Receive events immediately as they occur
- Multiple events: Subscribe to specific events based on your needs
- Robust security: HMAC signature verification with two methods available
- Automatic retries: Retry system with exponential backoff
- Flexible management: Enable, disable, or delete webhooks without affecting your integration
Next Steps
- Configuration: Start by setting up your first webhook
- Security: Implement signature verification on your endpoint
- Select your webhook type: Choose between Conversion, Identification, or Steps based on your use case
- Examples: Review sample code for your preferred language