API Access
🔑 Your API Key
Use this key to authenticate API requests
⚠️ Keep this secret!
Never share your API key publicly or commit it to version control. If compromised, contact support immediately to regenerate.
🚀 Quick Start
Submit a lead in under a minute
Send a POST request to our leads endpoint with your API key in the header:
// cURL Example
curl -X POST https://custom3dm.cloud/api/leads.php \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"name": "John Doe",
"email": "john@example.com",
"phone": "555-123-4567",
"message": "Interested in your services"
}'
📡 API Endpoints
Base URL: https://custom3dm.cloud/api
POST
/leads.php
Submit a new lead. Triggers email/SMS notifications based on your plan.
View Parameters
{
"name": "string", // Required
"email": "string", // Required
"phone": "string", // Optional
"company": "string", // Optional
"message": "string", // Optional
"source": "string", // Optional (e.g., "website", "landing-page")
"custom_fields": {} // Optional - any additional data
}
GET
/leads.php
Retrieve your submitted leads. Supports pagination and filtering.
View Parameters
// Query Parameters
?page=1 // Page number (default: 1)
&limit=20 // Results per page (max: 100)
&status=new // Filter: new, contacted, qualified, converted
&from=2024-01-01 // Filter: leads after this date
&to=2024-12-31 // Filter: leads before this date
GET
/usage.php
Check your current usage and plan limits.
📋 Response Codes
| Code | Meaning |
|---|---|
| 200 | Success - Request completed |
| 201 | Created - Lead submitted successfully |
| 400 | Bad Request - Check your parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 429 | Rate Limited - Too many requests |
| 500 | Server Error - Contact support |