API Documentation

Programmatically add leads to your LeadGen.ai account. Ideal for connecting web forms, Zapier/Make automations, or your own backend.

Authentication

Send your secret API key in the X-Api-Key header. Keep this key private and server-side. If you are logged in to the dashboard, session authentication also works for testing.

X-Api-Key: your-secret-key

Create a lead

POST https://leadgensoftware.futureminutes.com/api/leads

Content-Type: application/json

Request body

Field	Type	Required	Notes
`businessName`	string	Yes	Max 200 chars
`niche`	string	Yes	Category / keyword, max 200
`location`	string	No	City / area
`phoneNumber`	string	No	Max 30
`email`	string	No	Valid email
`website`	string	No	Full URL
`address`	string	No
`country`	string	No
`googleRating`	number	No	0–5
`reviewCount`	integer	No
`status`	string/int	No	Defaults to New
`facebookUrl`, `instagramUrl`, `linkedInUrl`, `xUrl`, `youTubeUrl`, `tikTokUrl`	string	No	Social profile URLs

Example request

curl -X POST "https://leadgensoftware.futureminutes.com/api/leads" \
  -H "X-Api-Key: your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Joe''s Plumbing",
    "niche": "plumbing",
    "location": "Austin TX",
    "phoneNumber": "+15125550123",
    "email": "joe@example.com",
    "website": "https://joesplumbing.example"
  }'

Success response (201 Created)

{
  "success": true,
  "message": "Lead \"Joe's Plumbing\" created successfully.",
  "leadId": 1234,
  "leadSearchId": 567,
  "businessName": "Joe's Plumbing",
  "opportunityScore": 82,
  "status": "New"
}

Error responses

400 — validation failed (missing required field, invalid email, etc.)
401 — missing or invalid X-Api-Key
500 — unexpected server error

Need an API key? Contact us to enable API access for your account.