Submit Lead

API endpoint to submit a new lead.

Submit leads programmatically from your own forms or integrations.

Endpoint

POST /api/v1/leads

Request body

{
  "directory_id": "dir_abc123",
  "form_id": "form_xyz789",
  "email": "customer@example.com",
  "name": "John Smith",
  "phone": "555-1234",
  "message": "I need a plumber for a leaky faucet",
  "category": "plumbing",
  "location": "Los Angeles, CA"
}

Response

{
  "id": "lead_def456",
  "status": "distributed",
  "quality_score": 85,
  "created_at": "2024-01-15T10:30:00Z"
}

Required fields

  • directory_id - Your directory ID
  • email - Customer email