Build on Engagor
Access your email intelligence programmatically. The Engagor API exposes health scores, metrics, alerts, and insights. Outbound webhooks push real-time events to Slack, PagerDuty, or your own systems.
RESTful endpoints. Real-time webhooks. Enterprise-grade authentication.
/v1/health/identity/{id}
Bearer sk_live_...
{
"identity": "BE-B2C-Commercial",
"health_score": 92,
"delivery_rate": 98.2,
"bounce_rate": 1.4,
"complaint_rate": 0.02,
"status": "healthy",
"last_updated": "2024-12-21T16:00:00Z"
}Endpoints for every use case
Access metrics, health scores, alerts, and more. All endpoints return JSON and support pagination, filtering, and sorting.
/v1/health/domain/{domain}
Get health score and metrics for a sending domain. Includes DNS status, delivery rates, and risk assessment.
/v1/health/identity/{id}
Get health score and metrics for a specific sending identity. Includes delivery, engagement, and risk metrics.
/v1/scores/overall
Get overall health scores across all identities. Perfect for executive dashboards and status pages.
/v1/alerts/active
List all active alerts and anomalies. Filter by severity, identity, or type.
/v1/metrics/deliverability
Detailed deliverability metrics by time period, ISP, and identity. Supports aggregation and breakdown.
/v1/metrics/engagement
Engagement metrics including opens, clicks, and conversions. Filter by cohort, device, or geography.
Push events to your systems
Don't poll - let Engagor push events to you. Configure webhook endpoints for alerts, anomalies, and status changes.
reputation_drop
Triggered when delivery rate drops below threshold
deferral_spike
Triggered when deferrals exceed normal baseline
anomaly_detected
Triggered when AI detects unusual patterns
dns_issue
Triggered when SPF/DKIM/DMARC problems found
{
"event": "reputation_drop",
"timestamp": "2024-12-21T16:05:00Z",
"identity": "BE-B2C-Commercial",
"severity": "critical",
"details": {
"current_rate": 94.2,
"baseline_rate": 98.5,
"drop_percent": 4.3,
"affected_isp": "gmail"
},
"recommendation": "Check recent campaigns for content issues"
}Enterprise-grade authentication
API Keys
Generate scoped API keys with granular permissions. Rotate keys without downtime.
HTTPS Only
All API traffic encrypted with TLS 1.2+. No plaintext endpoints.
IP Allowlisting
Restrict API access to specific IP ranges for additional security.
Rate Limiting
Generous rate limits with clear headers. Enterprise customers get higher limits.
Ready to build on Engagor?
See how the API can power your email operations.