Developers

Build with WarmupSleuth API

Integrate email warmup and deliverability monitoring into your application with our comprehensive REST API. Available from Pro plan and above.

API Documentation Get API Key

300+ REST Endpoints

Full CRUD for mailboxes, warmup sessions, analytics, organizations, billing, users, and admin operations. Everything is accessible via API.

Webhook Events

Real-time notifications for warmup progress, reputation changes, deliverability alerts, and billing events. Push-based architecture for instant updates.

OAuth2 Integration

Secure OAuth2 flows for Gmail and Microsoft 365. Token-based authentication with automatic refresh. No passwords stored on our servers.

Per-Plan Rate Limiting

Redis sliding window rate limiter ensures fair usage. From 60 req/min (Starter) up to 5,000 req/min (Enterprise). Configurable via plan tiers.

Quick Start

Check a warmup session status with a single API call.

terminal

# Check warmup session status
curl -X GET "https://api.warmupsleuth.com/warmup/sessions/ws_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# Response
{
  "id": "ws_abc123",
  "mailbox_id": "mb_def456",
  "status": "active",
  "phase": 3,
  "day": 28,
  "daily_limit": 50,
  "emails_sent_today": 42,
  "reputation_score": 92.5,
  "inbox_placement_rate": 0.96,
  "next_phase_at": "2026-04-05T00:00:00Z"
}

SDKs

Official SDK libraries for popular languages. Sign up to be notified when they launch.

Python

Coming Soon

Node.js

Coming Soon

Ruby

Planned

Ready to integrate?

Explore the full API documentation with interactive examples, request/response schemas, and authentication guides.

View Full API Docs