API Reference

The LeadSail API provides programmatic access to all platform features. Use the API to submit leads, manage campaigns, configure delivery endpoints, and more.

Base URL

https://api.leadsail.app/api/v1

Authentication

All API requests require an API key. Include it in the X-API-Key header:

X-API-Key: <your_api_key>

API keys can be generated from the Settings page in your LeadSail dashboard. See API Keys for setup instructions.

Response Format

All responses follow a consistent envelope:

{
  "success": true,
  "data": { ... }
}

Error responses include details:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Human readable error message",
    "details": []
  }
}

Rate Limiting

API requests are rate limited to protect service availability. Standard limits apply unless otherwise noted on individual endpoints.

Resources

Browse the endpoint reference pages below for detailed request/response documentation.