Feature - Webhooks

  1. Home
  2. Feature - Webhooks

TrackonAI's Webhooks provide enterprise-grade, real-time event streaming powered by AWS DynamoDB Streams. Whether you're integrating with your ERP system, pushing contract updates to Logo Tiger, or automating shipment notifications to external platforms, our webhook system delivers millisecond-latency updates with complete audit trails and zero data loss.

Webhooks in TrackonAI

Built on AWS serverless infrastructure, our webhook system automatically captures every CREATE, UPDATE, and DELETE operation across all entities in your tenant. Configure which events trigger webhooks, apply custom filters, add authentication headers, and monitor delivery success through CloudWatch—all through simple metadata configuration.

Architecture: TrackonAI webhooks run as a dedicated Lambda consumer on the same DynamoDB Stream that powers our S3 Tables audit logging. This ensures webhooks are completely isolated from your core operations—webhook failures never impact your system performance.

Simple Configuration

Enable webhooks for any entity through our metadata system. Here's an example configuration for sending CONTRACT updates to your ERP: 

{
  "entityName": "CONTRACT",
  "entityParameters": {
    "webhooks": {
      "enabled": true,
      "url": "https://your-erp.com/api/contracts",
      "events": ["CREATE", "UPDATE"],
      "filters": {
        "status": ["Approved", "Active"]
      },
      "headers": {
        "Authorization": "Bearer {{WEBHOOK_TOKEN}}",
        "Content-Type": "application/json"
      },
      "timeout": 10
    }
  }
}

  • Stream-Based Architecture

    Webhooks consume DynamoDB Streams directly, ensuring every entity change is captured with sub-second latency and complete isolation from your core operations.

    Stream-Based Architecture

    Millisecond Latency
    Zero Data Loss
    Complete Isolation
    No Performance Impact

  • Advanced Filtering

    Control exactly which events trigger webhooks with field-level filters. Only send notifications when specific fields change to specific values.

    Advanced Filtering

    Field-Level Filters
    Event Type Selection (CREATE/UPDATE/DELETE)
    Value-Based Triggers
    Reduce Noise

  • Enterprise Security

    Built-in SSRF protection, URL validation, and environment variable injection prevention. Custom authentication headers with secure credential management.

    Enterprise Security

    SSRF Protection
    URL Whitelisting
    Secure Headers
    AWS IAM Integration

  • CloudWatch Monitoring

    Real-time metrics for webhook success/failure rates. Configure CloudWatch alarms to alert your team when webhook delivery issues occur.

    CloudWatch Monitoring

    Success/Failure Metrics
    Custom Alarms
    Per-Entity Tracking
    Performance Insights

  • Developer-Friendly Docs

    Comprehensive documentation with webhook payload examples, retry policies, and authentication patterns. Get your integration running in minutes.

    Developer-Friendly Docs

    Payload Examples
    Authentication Guides
    Testing Tools
    Quick Start

  • Multi-Tenant Isolation

    Each tenant configures their own webhook endpoints independently. Complete data isolation ensures your integrations never see data from other tenants.

    Multi-Tenant Isolation

    Tenant-Specific URLs
    Independent Configuration
    Data Privacy
    Custom Headers Per Tenant

Technical Features

Event Types Supported
  • CREATE: New entity records
  • UPDATE: Modified entity records
  • DELETE: Soft-deleted entities (via _deleteOperation marker)
Webhook Payload
  • Complete entity data in native format
  • Tenant ID and entity metadata
  • Operation type and timestamp
  • Previous values (for UPDATE events)
Reliability Features
  • Automatic retry with exponential backoff
  • Configurable timeouts (default 10s)
  • HTTP connection pooling
  • CloudWatch failure logging
Security Measures
  • HTTPS-only webhook URLs
  • Private IP address blocking
  • Environment variable substitution
  • Custom authentication headers

Common Use Cases

ERP Integration

Automatically sync approved contracts, invoices, and payments to systems like Logo Tiger, SAP, or NetSuite. Filter for "Approved" status changes and push complete accounting data to your financial system in real-time.

Shipment Tracking

Send shipment milestone updates to customer portals or internal dashboards. Configure webhooks on SHIPMENT entities to notify when vessels depart, clear customs, or complete delivery.

Workflow Automation

Trigger Step Functions or external automation platforms when contracts reach specific states. Build approval chains, notification systems, or custom business logic that responds instantly to TrackonAI events.

Analytics & BI

Stream operational data to data warehouses, analytics platforms, or custom dashboards. Process events through ETL pipelines for real-time business intelligence without polling APIs.

By leveraging Webhooks, you gain complete control over how TrackonAI integrates with your existing technology stack. Our stream-based architecture ensures reliable delivery, our filtering system reduces noise, and our security measures protect your data—all while maintaining the sub-second latency needed for modern commodity trading operations. Whether you're connecting to a legacy ERP system or building cutting-edge automation, TrackonAI webhooks provide the foundation for seamless integration.

Webhook flows seamlessly between TrackonAI and ERP systems
Stream-based notifications triggered by entity changes in TrackonAI
Teams building custom solutions with TrackonAI's webhook system