API Reference/Documentation
GitHubDashboard
Platform

Analytics & Reporting

Track engagement events (email opens, clicks, replies, bounces), view dashboard metrics, run funnel/cohort analysis, generate reports, and export data for BI tools.

Engagement Tracking

Opens, clicks, replies, bounces

Dashboard & KPIs

Real-time metrics and funnels

Reports

Custom reports and scheduling

Predictive

ML-powered lead scoring

Engagement Events

Individual engagement events track email opens, link clicks, replies, bounces, form submissions, and page visits. These events power workflow conditions (e.g. "if email opened") and engagement analytics.

Info

Events are typically ingested automatically by the communication-service tracking infrastructure (open pixels, click redirects, inbound email processing). Use the manual ingestion endpoint for custom integrations or testing.

Ingest Event

Body Parameters

ParameterTypeDescription
eventTypereq
stringEvent type: email_open, link_click, email_reply, email_bounce, email_sent, form_submission, page_visit
leadId
stringAssociated lead ID
messageId
stringAssociated message/communication log ID
workflowExecutionId
stringAssociated workflow execution ID (for sequence tracking)
timestamp
stringISO 8601 timestamp (defaults to now)
Request
HTTP
http
POST https://api.leadron.io/v1/analytics/events
X-API-Key: ldr_live_sk_a1b2c3d4e5f6g7h8i9j0
Content-Type: application/json
Body
json
1
2
3
4
5
6
{
  "eventType": "email_open",
  "leadId": "6789abcdef012345",
  "messageId": "msg_001",
  "workflowExecutionId": "exec_001"
}
Response201Created
201 Response
json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "success": true,
  "status": 201,
  "message": "Event ingested",
  "data": {
    "id": "evt_001",
    "tenantId": "acme-corp",
    "type": "email_open",
    "leadId": "6789abcdef012345",
    "messageId": "msg_001",
    "workflowExecutionId": "exec_001",
    "timestamp": "2026-02-09T10:30:00.000Z"
  },
  "meta": {
    "timestamp": "2026-02-09T10:30:00.000Z",
    "version": "v1"
  }
}

Lead Engagement

Form Submissions

Page Visits

Dashboard

KPIs

Funnel

Cohort Analysis

Team Performance

Export

Predictive Analytics

Reports

Scheduled Reports