Field changes
Leads — remove tags on Update Lead
PUT /v1.0/leads/{leadId} gains two request fields for removing tags without resending the full list:tagsRemove(string array) — removes the named tags from the lead. Names are matched literally; a name not currently on the lead is ignored. Applied aftertags/tagsAdd.clearAllTags(boolean, defaultfalse) — set totrueto remove all tags from the lead. Takes precedence overtags/tagsAdd/tagsRemove.
tags.New endpointsWebhooksField changesFixes
Communications — Cursor-paged search
AddedGET /v2.0/communication/agent — cursor-paginated search of an agent’s communications. Supports type=ALL to merge calls, texts, and emails; a query window of up to 90 days; and search_after-based pagination via an opaque cursor (replacing offset paging). The response includes data, nextCursor, hasMore, limit, and totalCount.Webhooks — Ownership-based delivery
Added apermissionMode field on POST /v1.0/webhook:0(default) — assignment-based delivery; unchanged behavior.1— ownership-based delivery; the subscriber also receives callbacks for any lead within their ownership scope (team, office, or personally owned), not only assigned leads.
Field Changes
- System Logs (
GET /v1.0/systemLogs) — each entry now includestimelineTypeDesc, a human-readable event name paired with the integertimelineType, so you no longer need to map the integer yourself.
Fixes
- Leads (
GET /v1.0/leads) — theopportunityfield is now correctly populated (it previously always returned empty).
New endpoints
Communications — single-record lookups
Added v2 endpoints to fetch a single communication by ID:GET /v2.0/communication/call/{communicationId}GET /v2.0/communication/text/{communicationId}GET /v2.0/communication/email/{communicationId}
New endpointsField changesNew tools
Lofty CLI
Released@loftyai/lofty-cli — a command-line tool for the Lofty API. Manage leads, agents, listings, tasks, transactions, and more from your terminal.Transaction V2 Search
AddedGET /v2.0/transactions — paginated transaction search with keyword, lead, and date filters.Lead Query Enhancements
New parameters forGET /v1.0/leads:returnFields: Specify which fields to return (comma-separated), reducing payload size.otherFilters: Pass custom LeadFilter overrides for advanced filtering.key: Fuzzy search by name, phone, or email in a single parameter.
Field Changes
- Calendar V2 —
startTime/endTimenow accept millisecond timestamps in addition to ISO 8601. - Manual Log (
POST /v1.0/logType) — AddedemailSubject,toEmail,fromEmailfields for email log entries. - Manual Log (
POST /v1.0/logType) — The response now returns the created entry’sid. - Manual Log (
GET /v1.0/logType) — Addedsort/orderparameters to control result ordering, and the response now includes thecontentfield.
New endpointsNew featuresAuthentication
Sales Agents & AI
8 new endpoints for managing Sales Agent workflows:GET /v2.0/sales-agents/by-lead— Get Sales Agent by lead IDGET /v2.0/sales-agents/quota— Get current user’s quotaGET /PUT /v2.0/sales-agent/settings— Query and update settingsPUT /v2.0/sales-agents/working-lead/{leadId}/mute— Mute a working leadPOST /v2.0/working-leads/add— Batch add leads to working poolPOST /v2.0/plan-tasks/create— Batch create plan tasks
Intelligent Features (AI)
6 new AI-powered endpoints:POST /v2.0/ai/call-script— Generate call scriptGET /POST /v2.0/ai/call-summary— Get or trigger call summary generationPOST /v2.0/ai/prepare-insight— Generate prepare insightGET /POST /v2.0/ai/lead-analysis— List or create lead analysis tasks
Calendar V2
Full CRUD + lifecycle management for calendar events:GET /POST /v2.0/calendar— List and create eventsPUT /DELETE /v2.0/calendar/{calendarId}— Update and delete eventsPOST finish/unfinish— Mark events as completed or reopenGET /v2.0/calendar/meetings/available— List available meeting slots
Tasks V2 Enhancements
GET /v2.0/tasks/my-tasks— List tasks and appointments assigned to the current userPOST finish/unfinish— Mark tasks as completed or reopen
Lead Activity V2
GET /v2.0/leads/{leadId}/activities— Unified timeline with calls, texts, and emails in chronological order
Listing V2
POST /v2.0/listings/search— Search by location, price, beds, baths, property type- Replaced
locationsarray with simplerkey/keywordTypeparams
Notifications
POST /v2.0/sales-agent/notification/app-push/send-task-reminder— Task reminder pushPOST send-to-agent— Send system SMS or email to agentPOST /v2.0/sales-agent/ai-number/send-sms-to-agent— Send SMS via AI number
Agent Tags
POST /v1.0/agent/{agentId}/tag/add— Batch add tags with autoCreate support
Field Changes
- Listing — Added
propertyTypePrimaryandpropertyTypeSecondaryto response - Note — Added
noteId,noteType,idOfTypefields - Calendar V2 — Added
taskIdfield to calendar items
Authentication
- Added OAuth 2.0 Client Credentials flow (
/oauth/token) for server-to-server integrations - Added per-app rate limiting and token scope enforcement