API Documentation

Build custom integrations with Aeronex CRM

Quick Start

All API requests require authentication using an API key. Include your key in the Authorization header.

Authorization: Bearer aeronex_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

List Leads

GET

Retrieve all leads

Endpoint

GET https://api.aeronex.com/api/v1/leads

Example Request

curl -X GET https://api.aeronex.com/api/v1/leads \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "companyName": "Acme Corp",
      "contactEmail": "[email protected]",
      "industry": "Technology",
      "stage": "lead_captured"
    }
  ],
  "count": 1
}

Create Lead

POST

Create a new lead

Endpoint

POST https://api.aeronex.com/api/v1/leads

Request Body

{
  "companyName": "Tech Startup Inc",
  "contactName": "Jane Smith",
  "contactEmail": "[email protected]",
  "industry": "Software",
  "source": "api"
}

Example Request

curl -X POST https://api.aeronex.com/api/v1/leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Tech Startup Inc",
    "contactEmail": "[email protected]"
  }'

Rate Limiting

API requests are rate-limited based on your API key configuration. Default limit is 1000 requests per hour.

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 999

X-RateLimit-Reset: 1644254400

Error Handling

API errors follow standard HTTP status codes:

400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error