CooVexCooVex
Back to docs

API: Leads endpoints

REST API reference for reading and managing leads from your own application.

List leads

GET https://app.coovex.com/api/v1/leads
Authorization: Bearer YOUR_API_KEY

Query parameters: page, limit (max 100), status, min_score

Create a lead

POST https://app.coovex.com/api/v1/leads
{
  "name": "Jane Smith",
  "email": "jane@acmecorp.com",
  "company": "Acme Corp",
  "status": "new"
}

Update a lead

PATCH https://app.coovex.com/api/v1/leads/:id
{ "status": "qualified" }

Delete a lead

DELETE https://app.coovex.com/api/v1/leads/:id
# Returns 204 No Content

Webhook events

  • lead.created
  • lead.hot — score crossed 80
  • lead.score_changed
  • lead.status_changed