The Leads API gives you programmatic access to every stage of the lead lifecycle in Lofty. Use it to import leads from external sources, sync CRM data, automate assignment workflows, and retrieve activity history for reporting and compliance. All endpoints require a valid Bearer token in theDocumentation Index
Fetch the complete documentation index at: https://developer.lofty.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorization header. See Authentication for details.
Lead IDs (
leadId) are 64-bit integers. Use a long or BigInt type in your language of choice — standard 32-bit integers will overflow.Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v1.0/leads | List and filter leads with pagination |
POST | /v1.0/leads | Create a new lead |
GET | /v1.0/leads/{leadId} | Get a single lead by ID |
PUT | /v1.0/leads/{leadId} | Update an existing lead |
DELETE | /v1.0/leads/{leadId} | Move a lead to the trash |
POST | /v1.0/leads/{leadId}/assignment | Assign a lead to one or more agents |
POST | /v1.0/leads/assignee | Preview routing assignees without creating a lead |
GET | /v2.0/leads/{leadId}/activities | List call, text, and email activity for a lead |
GET | /v1.0/leads/{leadId}/activities | List site-tracked activities (browse, search, favorite) |
POST | /v1.0/leads/{leadId}/activity | Log an external communication as a site activity |
GET | /v1.0/systemLogs | Retrieve the system-generated audit trail for a lead |
Base URL
Related resources
- Managing leads guide — end-to-end walkthrough of lead operations
- Authentication — how to obtain an access token