Event Ingestion

The event ingestion API is the primary way to get data into Waypath. All events are normalized, identity-resolved, and written to both the CRM store and intelligence layer.

01Track a touchpoint

POST /v1/events/track
X-API-Key: wp_live_your_key
Content-Type: application/json

{
  "action": "email_opened",
  "customerId": "cust_123",
  "campaignId": "camp_456",
  "channel": "email",
  "properties": {
    "subject": "Spring Sale",
    "timestamp": "2026-03-15T10:30:00Z"
  }
}

This creates:

• A Touchpoint node with HAS_TOUCHPOINT edge to the Customer
• An INFLUENCED_BY edge to the Campaign (if campaignId provided)
• A Channel node with VIA_CHANNEL edge

02Identify a customer

POST /v1/events/identify
X-API-Key: wp_live_your_key
Content-Type: application/json

{
  "email": "sarah@example.com",
  "name": "Sarah Chen",
  "phone": "+1-555-0123",
  "externalId": "hubspot_12345",
  "properties": {
    "company": "Acme Corp",
    "title": "VP Marketing"
  }
}

Identity resolution runs automatically, matching by:

• Email (confidence: 1.0)
• Phone (confidence: 0.9)
• External ID (confidence: 0.8)

If no match is found, a new Customer node is created.

03Batch ingestion

POST /v1/events
X-API-Key: wp_live_your_key
Content-Type: application/json

{
  "events": [
    { "type": "track", "action": "page_view", "customerId": "cust_1", ... },
    { "type": "identify", "email": "user@example.com", ... },
    { "type": "track", "action": "purchase", "customerId": "cust_2", ... }
  ]
}

Events are processed sequentially. Identity resolution runs on each event.

04Pipeline flow

Event received
  -> Identity Resolution (match or create Customer)
  -> Write CRM record (Pipeline)
  -> Build intelligence entities + relationships
  -> WebSocket broadcast (real-time UI update)