Introduction - LeadTrackr

The LeadTrackr API lets you create leads, retrieve lead data, and update lead statuses programmatically.

The LeadTrackr API is currently in beta. While fully functional, endpoints and request/response formats may change as we refine the API. If you notice anything unexpected or have feedback, please reach out at support@leadtrackr.io.

Base URL

All API requests are made to:

https://app.leadtrackr.io

Request format

All request bodies must be sent as JSON with Content-Type: application/json.
All responses return JSON.

Response format

Every response includes a message field describing the result:

{
  "message": "Lead created successfully",
  "leadId": 42,
  "uniqueIdentifier": "crm-lead-456"
}

Error handling

Errors return an appropriate HTTP status code with a message field:

Status	Meaning
`400`	Bad request — missing or invalid parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — project subscription is inactive
`404`	Not found — project or lead does not exist
`405`	Method not allowed
`409`	Conflict — duplicate operation
`500`	Internal server error

{
  "message": "Missing required field: projectId"
}

Endpoints

Create Lead

Create a lead from client-side sources (GTM, browser)

Create Server-Side Lead

Create a lead from your backend using an API key

Get Lead

Retrieve a single lead by ID, email, phone, or unique identifier

Get Leads

List and filter leads with pagination

Update Lead Status

Queue a lead for conversion processing

​Base URL

​Request format

​Response format

​Error handling

​Endpoints

Create Lead

Create Server-Side Lead

Get Lead

Get Leads

Update Lead Status

Base URL

Request format

Response format

Error handling

Endpoints