Analytics

Contact fatigue scores, send velocity, deliverability rates, segment membership, and outcome attribution.

The analytics API gives you real-time insight into contact engagement, sending patterns, and deliverability — plus outcome attribution to measure the impact of your campaigns.

Contact fatigue

Get a fatigue score (0–100) for a contact with a recommendation on whether to send.

GET https://api.molted.email/v1/agent/analytics/contact-fatigue

curl

curl "https://api.molted.email/v1/agent/analytics/contact-fatigue?tenantId=tenant_abc123&contactEmail=user@example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "contactEmail": "user@example.com",
  "fatigueScore": 72,
  "recommendation": "stop_sending"
}

Score range	Recommendation
0–39	`safe_to_send` — contact is not fatigued.
40–69	`reduce_frequency` — consider spacing out sends.
70–100	`stop_sending` — contact is over-saturated.

Send velocity

Check your sending rate across different time windows.

GET https://api.molted.email/v1/agent/analytics/send-velocity

curl

curl "https://api.molted.email/v1/agent/analytics/send-velocity?tenantId=tenant_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "hourly": 12,
  "daily": 156,
  "weekly": 892
}

Deliverability

Get bounce and complaint rates across time windows.

GET https://api.molted.email/v1/agent/analytics/deliverability

curl

curl "https://api.molted.email/v1/agent/analytics/deliverability?tenantId=tenant_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "periods": {
    "24h": { "sent": 45, "delivered": 43, "bounced": 1, "complained": 0, "bounceRate": 0.022, "complaintRate": 0.0 },
    "7d": { "sent": 312, "delivered": 305, "bounced": 4, "complained": 1, "bounceRate": 0.013, "complaintRate": 0.003 },
    "30d": { "sent": 1240, "delivered": 1210, "bounced": 18, "complained": 3, "bounceRate": 0.015, "complaintRate": 0.002 }
  }
}

Segment check

Check whether a contact is currently a member of a given segment.

GET https://api.molted.email/v1/agent/analytics/segment-check

curl

curl "https://api.molted.email/v1/agent/analytics/segment-check?tenantId=tenant_abc123&contactEmail=user@example.com&segmentId=SEGMENT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "contactEmail": "user@example.com",
  "segmentId": "SEGMENT_ID",
  "isMember": true,
  "computedAt": "2026-03-01T11:00:00Z"
}

Attribution

Track outcomes and measure the impact of your email campaigns and journeys.

Ingest outcomes

Record conversion or outcome events tied to contacts.

POST https://api.molted.email/v1/outcomes/ingest

curl

curl -X POST https://api.molted.email/v1/outcomes/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "tenant_abc123",
    "events": [
      {
        "contactEmail": "user@example.com",
        "eventType": "purchase",
        "value": 99.99,
        "occurredAt": "2026-03-01T15:30:00Z"
      }
    ]
  }'

List outcomes

GET https://api.molted.email/v1/outcomes

curl

curl "https://api.molted.email/v1/outcomes?tenantId=tenant_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Journey impact

Measure the impact of a journey on outcomes.

GET https://api.molted.email/v1/outcomes/journey-impact

curl

curl "https://api.molted.email/v1/outcomes/journey-impact?tenantId=tenant_abc123&journeyId=JOURNEY_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Attribution models

Model	Description
`first_touch`	100% credit to the first email interaction.
`last_touch`	100% credit to the last email interaction before conversion.
`linear`	Credit distributed equally across all email interactions.
`time_decay`	More credit to interactions closer to the conversion event.

On this page