API Integration
Powerful REST API for Custom Integrations
Integrate WarmySender with your existing tools and workflows using our comprehensive REST API with webhooks, authentication, and full platform access.
API Integration: The Foundation of Modern Sales Automation
In today's competitive sales landscape, the ability to seamlessly connect your email warmup platform with your existing technology stack is not just a convenience—it is a necessity. WarmySender's API integration capabilities transform a standalone email warmup tool into a powerful node within your sales automation ecosystem, enabling workflows that were previously impossible or prohibitively expensive to implement.
REST API Architecture and Design Principles
WarmySender's API follows REST architectural principles, providing a predictable, resource-oriented interface that developers can quickly understand and integrate.
Core API Design Principles:
- Resource-oriented URLs: Endpoints structured around resources (mailboxes, prospects, campaigns)
- Standard HTTP methods: GET for retrieval, POST for creation, PATCH for updates, DELETE for removal
- Consistent response formats: Unified JSON schema with predictable error structures
- Idempotency support: Safe retry logic for critical operations
- Versioned endpoints: API versions specified in URL path
Primary API Endpoints
Mailbox Management
- GET /api/v1/mailboxes - List all connected mailboxes
- GET /api/v1/mailboxes/:id - Retrieve mailbox details
- POST /api/v1/mailboxes/:id/warmup/start - Start warmup
- PATCH /api/v1/mailboxes/:id/warmup/settings - Update warmup settings
Prospect Management
- GET /api/v1/prospects - List prospects with filtering
- POST /api/v1/prospects - Create individual prospects
- POST /api/v1/prospects/bulk - Bulk import up to 1,000 per batch
- GET /api/v1/prospects/:id/activity - Retrieve engagement history
Campaign Control
- GET /api/v1/campaigns - List all campaigns
- POST /api/v1/campaigns - Create new campaigns
- GET /api/v1/campaigns/:id/stats - Retrieve campaign analytics
- POST /api/v1/campaigns/:id/start - Launch campaign
API Authentication and Security
All API requests require authentication via API keys generated through your WarmySender dashboard. Keys are workspace-scoped with configurable permissions.
Webhook Notifications
Webhooks enable real-time notifications when events occur:
- email.sent, email.opened, email.clicked, email.replied
- email.bounced, prospect.unsubscribed
- mailbox.health_changed, warmup.milestone
- campaign.completed
CRM Integration Possibilities
The API enables deep integration with HubSpot, Salesforce, Pipedrive, and other CRM platforms for contact synchronization, activity logging, and workflow automation.
The $49 Lifetime Pricing Advantage for API Users
Unlike some competitors who gate API access behind enterprise pricing tiers, WarmySender includes full API access with every license at $49 lifetime.
Key Benefits
- Full REST API access for all platform features
- Webhook notifications for real-time events
- API key authentication with permission scopes
- Prospect, campaign, and mailbox management endpoints
- Comprehensive API documentation
- Rate limiting with clear headers
- Integration with CRM and sales tools
Frequently Asked Questions
Is API access included in the $49 price?
Yes, full API access is included in the $49 lifetime price. All endpoints, webhooks, and integration capabilities are available with no additional charges or enterprise upgrade required.
What can I do with the API?
The API provides full platform access: manage mailboxes and warmup settings, create and control campaigns, import and manage prospects, retrieve analytics, and receive webhook notifications for real-time events.
How do I authenticate API requests?
API requests are authenticated using API keys generated from your WarmySender dashboard. Keys are passed via the Authorization header using Bearer token scheme. Keys can be scoped with specific permissions.
What are the rate limits?
Standard rate limit is 100 requests per minute per API key with burst allowance up to 20 requests per second. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.
Can I receive real-time notifications?
Yes, webhooks notify your systems of events in real-time: email sent/opened/clicked/replied, bounces, unsubscribes, mailbox health changes, and campaign completions. Configure webhook endpoints in your dashboard.
Is there API documentation?
Yes, comprehensive API documentation is available with request/response examples, authentication guides, and endpoint references. Documentation covers all available endpoints and webhook event types.