Webhooks

Receive real-time data from external platforms via inbound webhooks.

Platform webhook

POST /api/webhooks/:platform
Content-Type: application/json
 
{
  // Platform-specific webhook payload
}

Replace :platform with the integration name (e.g., customer-io, hubspot). The webhook handler normalizes the payload into a MarketingEvent and processes it through the standard ingestion pipeline.

Generic webhook

POST /api/webhooks/generic
Content-Type: application/json
 
{
  "type": "track",
  "action": "custom_event",
  "customerId": "cust_123",
  "properties": {
    "key": "value"
  }
}

Use the generic webhook endpoint for custom integrations that don’t have a dedicated platform handler. The payload follows the same MarketingEvent format as the event ingestion API.