API Reference
Complete API reference for integrating LeadNest into your applications.
Authentication
All API requests require authentication using your API key:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Base URL
https://api.leadnest.ai/v1
Send Email
Send a transactional or marketing email:
Endpoint
POST /email/send
Request Body
{
"to": "user@example.com",
"subject": "Welcome!",
"html": "
Hello
", "from": { "email": "noreply@yourdomain.com", "name": "Your Company" } }Response
{
"success": true,
"message_id": "msg_abc123",
"status": "queued"
}
Send SMS
Send an SMS message:
Endpoint
POST /sms/send
Request Body
{
"to": "+1234567890",
"message": "Your verification code is 123456",
"from": "YourBrand"
}
Send WhatsApp Message
Send a WhatsApp template message:
Endpoint
POST /whatsapp/send
Request Body
{
"to": "+1234567890",
"template": "welcome_message",
"language": "en",
"parameters": {
"name": "John"
}
}
Rate Limits
API rate limits:
- Starter Plan: 100 requests/minute
- Pro Plan: 1,000 requests/minute
- Enterprise: Custom limits
Error Codes
- 400: Bad Request - Invalid parameters
- 401: Unauthorized - Invalid API key
- 429: Too Many Requests - Rate limit exceeded
- 500: Internal Server Error
SDKs
Official SDKs available for:
- JavaScript/Node.js
- Python
- PHP
- Ruby
- Java
Coming Soon Features
We're constantly working on new features to help you scale your communications. Here's what's currently in development:
AI Lead Scoring
Predictive Optimization
Multi-language Bots
Expanded CRM Sync
Need Help Getting Started?
Book a personalized demo with our team and discover how LeadNest can transform your communication strategy.