Webhooks

Real-time event delivery system for instant data synchronization and automation

What Are Webhooks?

Webhooks are automated messages sent from one system to another when specific events occur

Traditional Polling

Check every 5 minutes

Wasteful API calls

Delayed notifications

Webhook Push

Instant notifications

Efficient resource usage

Real-time updates

Benefits of Webhooks

Real-Time Updates

Instant notifications when data changes occur

Immediate event processing
No polling delays
Live data synchronization
Instant user notifications

Efficient Resource Usage

Reduce API calls and server load

Lower bandwidth usage
Reduced server load
Better scalability
Cost optimization

Reliable Event Delivery

Guaranteed event delivery with retry logic

Automatic retry on failure
Event persistence
Delivery guarantees
Failure notifications

Available Webhook Events

Integrations

Events related to integrations in Astralis

integration.connectedReal-time

New integration successfully connected

integration.disconnectedReal-time

Integration access revoked

integration.errorReal-time

Integration encountered an error

integration.token_refreshReal-time

OAuth token automatically refreshed

Documents

Events related to documents in Astralis

document.uploadedReal-time

New document uploaded and processed

document.processedReal-time

Document OCR and AI processing completed

document.errorReal-time

Document processing failed

document.deletedReal-time

Document removed from system

Tasks & Pipelines

Events related to tasks & pipelines in Astralis

task.createdReal-time

New task automatically created

task.assignedReal-time

Task assigned to user or team

task.completedReal-time

Task marked as completed

pipeline.stage_changedReal-time

Task moved to different pipeline stage

AI & Automation

Events related to ai & automation in Astralis

ai.classification_completeReal-time

AI task classification finished

automation.triggeredReal-time

Automated workflow executed

automation.completedReal-time

Automation workflow finished

automation.errorReal-time

Automation encountered an error

Security & Reliability

Signature Verification

Cryptographic verification of webhook authenticity

const signature = crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(JSON.stringify(payload))
  .digest('hex');

const isValid = signature === request.headers['x-webhook-signature'];

Request Validation

Comprehensive validation of webhook payloads

JSON schema validation
Type checking
Required field validation
Sanitization

Rate Limiting

Protection against webhook abuse

Request throttling
IP-based limits
Event type limits
Automatic blocking

Webhook Implementation

How to set up and handle webhooks in your Astralis integration

Receiving Webhooks

1. Set up endpoint

POST https://yourapp.com/webhooks/astralis

2. Verify signature

check webhook signature header

3. Process event

handle based on event.type

Webhook Payload

{
  "id": "evt_1234567890",
  "type": "document.processed",
  "created": 1640995200,
  "data": {
    "documentId": "doc_123",
    "organizationId": "org_456",
    "status": "completed",
    "metadata": { ... }
  }
}

Security Note: Always verify webhook signatures to ensure authenticity. Store your webhook secret securely and rotate it regularly.

Best Practices

Recommendations for reliable webhook implementation

Implementation

• Always verify webhook signatures
• Implement idempotency to handle duplicates
• Return 200 status quickly to avoid timeouts
• Process webhooks asynchronously
• Log all webhook attempts for debugging

Reliability

• Implement retry logic for failed deliveries
• Monitor webhook health and latency
• Handle rate limits gracefully
• Set up alerts for webhook failures
• Test webhooks with sample payloads

Ready to Use Webhooks?

Start building real-time integrations with Astralis webhooks

API Reference Setup Integrations Webhook Support

Need help implementing webhooks? Check our API documentation or contact our support team.