Leads
List leads
POST/api/agent-gateway/leads
The seller leads the key's rep can see. Without cursor: newest activity first, at most limit, with truncated when more exist. With cursor: send "start", then each nextCursor, to walk every lead oldest-created first; a page can be empty while nextCursor has more, and nextCursor is null when done. Send the same filters on every page.
Scopes: leads:read
MCP tool: list_leads
| Field | Type | About |
|---|
stage | string | Only leads in this pipeline stage. |
ownerRepId | string | Only leads owned by this rep id. |
untouchedDays | integer | Only leads with no activity for at least this many days. At least 0. |
limit | integer | How many leads to return. 1 to 200. |
cursor | string | "start" to begin a walk, then the nextCursor from the previous page. Up to 8,192 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/leads \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cursor":"start","limit":200}'
Response 200: Without cursor: the leads, newest activity first, and truncated is true when there were more than limit. With cursor: one page of the walk, oldest created first, plus nextCursor to send next (null when done); a page can be empty while nextCursor has more.
{
"leads": [
{
"id": "lead_123",
"name": "Dana Whitfield",
"stage": "contact_made",
"source": "Direct mail",
"ownerName": "Jordan Smith",
"lastContactedAt": 1792159500000,
"callCount": 2,
"daysInStage": 4
}
],
"truncated": false,
"timelineSince": null
}
Get a lead
POST/api/agent-gateway/leadop get
One lead by id: contact details, stage, owner, recent outcomes, notes and counts. A lead the rep can't see answers 404.
Scopes: leads:read
MCP tool: get_lead
| Field | Type | About |
|---|
op (required) | "get" | |
leadId (required) | string | The lead's id. Up to 120 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"get","leadId":"<leadId>"}'
Response 200: The lead, with contact details, stage, owner and notes.
{
"lead": {
"id": "lead_123",
"name": "Dana Whitfield",
"stage": "contact_made",
"phones": [
"+15555550123"
],
"email": "seller@example.com",
"address": "123 Main St, Springfield, IL 62701",
"ownerName": "Jordan Smith",
"notes": "Wants to close before the end of October. Open to a cash offer.",
"daysInStage": 4,
"callExtensions": [
{
"phone": "+15555550123",
"ext": "204"
}
]
}
}
Find leads
POST/api/agent-gateway/leadop find
Search the leads the rep can see by name, phone or address. Give at least one.
Scopes: leads:read
MCP tool: find_lead
| Field | Type | About |
|---|
op (required) | "find" | |
name | string | Part of the seller's or company's name (2+ characters). Up to 120 characters. |
phone | string | A phone number in any format. Up to 120 characters. |
address | string | Part of the property address (2+ characters). Up to 120 characters. |
limit | integer | How many matches to return. 1 to 25. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"find","phone":"+15555550123","limit":5}'
Response 200: Matching leads the teammate can see.
{
"leads": [
{
"id": "lead_123",
"name": "Dana Whitfield",
"stage": "contact_made",
"phones": [
"+15555550123"
],
"email": "seller@example.com",
"address": "123 Main St, Springfield, IL 62701",
"ownerName": "Jordan Smith",
"lastActivityAt": 1792159500000
}
],
"truncated": false
}
Create a lead
POST/api/agent-gateway/lead-writeop createChanges data
Add a seller lead owned by the key's rep, in the account's acquisitions pipeline. An address, phone or email already on a lead, at any stage, answers 409 with the matching leads unless allowDuplicate is true.
Scopes: leads:write
MCP tool: create_lead
| Field | Type | About |
|---|
op (required) | "create" | |
contactName | string | The seller's name. Give this or an address. Up to 200 characters. |
companyName | string | The seller's company. Up to 200 characters. |
phone | string | The seller's phone number. Up to 200 characters. |
extension | string | An extension the phone dials after the call connects: up to 16 keys (digits, * and #), w = half-second pause, up to 10 seconds of pauses. Needs phone. Up to 64 characters. |
email | string | The seller's email address. Up to 200 characters. |
address | string | The property address. Up to 200 characters. |
value | number | The deal value in dollars. At least 0. |
source | string | Where the lead came from, as a marketing channel name. Up to 200 characters. |
stage | string | The stage key or name to start in. Defaults to the pipeline's first open stage. Up to 200 characters. |
allowDuplicate | boolean | Create the lead even when its address, phone or email is already on another lead. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-write \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"create","contactName":"Dana Whitfield","phone":"+15555550123","address":"123 Main St, Springfield, IL 62701","source":"Direct mail"}'
Response 200: The new lead's id and the stage it started in. A phone or email already on a lead answers 409 instead.
{
"leadId": "lead_124",
"stage": "new_lead"
}
Update a lead
POST/api/agent-gateway/lead-writeop updateChanges data
Change a lead's contact details, value, source, address or its lead fields. Stage, owner and system fields can't be set here; use the stage op for the stage.
Scopes: leads:write
MCP tool: update_lead
| Field | Type | About |
|---|
op (required) | "update" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
contactName | string | The seller's name. Up to 200 characters. |
companyName | string | The seller's company. Up to 200 characters. |
phone | any | The seller's phone number. Send null to clear it. |
extension | any | An extension dialed after the call connects, for phone if sent or else the lead's phone: up to 16 keys (digits, * and #), w = half-second pause, up to 10 seconds of pauses. null clears it. Send null to clear it. Up to 64 characters. |
email | any | The seller's email address. Send null to clear it. |
address | any | The property address. Send null to clear it. |
value | any | The deal value in dollars. Send null to clear it. |
source | any | The marketing channel name. Send null to clear it. |
fields | object | Lead fields by key, as set up in the account's lead fields (for example arv, askingPrice, motivation). Numbers for number and money fields, true/false for checkboxes, YYYY-MM-DD for dates, one of the options for dropdowns, a list of options (or options separated by ;) for multi-selects, null or [] to clear. |
fields.<key> | any | The field's new value. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-write \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"update","leadId":"<leadId>","email":"dana@example.com","fields":{"motivation":"Relocating","mot_timeline":"Within 30 days"}}'
Response 200: The lead's id and the fields that changed.
{
"leadId": "lead_123",
"changed": [
"contactName",
"phone"
]
}
Move a lead's stage
POST/api/agent-gateway/lead-writeop stageChanges data
Move a lead to another stage in its pipeline, by stage key or name. The stage's required fields and the lead's locks apply as in the app.
Scopes: leads:write
MCP tool: move_lead_stage
| Field | Type | About |
|---|
op (required) | "stage" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
stage (required) | string | The stage key or name. Up to 200 characters. |
lostReason | string | Why the deal was lost, when moving to a lost stage. Up to 200 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-write \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"stage","leadId":"<leadId>","stage":"contact_made"}'
Response 200: The lead's id, the stage it left and the stage it's in now.
{
"leadId": "lead_123",
"from": "new_lead",
"stage": "contact_made"
}
Add a note to a lead
POST/api/agent-gateway/lead-writeop noteChanges data
Add a note to the lead's timeline as the key's rep. @mentions notify teammates as in the app.
Scopes: leads:write
MCP tool: add_lead_note
| Field | Type | About |
|---|
op (required) | "note" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
body (required) | string | The note. Up to 10,000 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-write \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"note","leadId":"<leadId>","body":"Wants to close before the end of October. Open to a cash offer."}'
Response 200: The lead's id and the new note's id.
{
"leadId": "lead_123",
"noteId": "note_456"
}
Tag or untag a lead
POST/api/agent-gateway/lead-writeop tagChanges data
Add a tag to a lead (created if the account doesn't have it yet), or remove one with remove: true. DNC and DNT can be added but only removed in the app.
Scopes: leads:write
MCP tool: tag_lead
| Field | Type | About |
|---|
op (required) | "tag" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
tag (required) | string | The tag's label. Up to 40 characters. |
remove | boolean | Remove the tag instead of adding it. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-write \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"tag","leadId":"<leadId>","tag":"Motivated"}'
Response 200: The lead's id, the tag, whether it's now on, and whether anything changed.
{
"leadId": "lead_123",
"tag": "Motivated",
"on": true,
"changed": true
}
Projects & properties
Project book
POST/api/agent-gateway/projects
Rehab projects with budget, schedule and open tasks, or one project by id.
Scopes: projects_properties:read
MCP tool: list_projects
| Field | Type | About |
|---|
today (required) | string | Today's date in the account's time zone (YYYY-MM-DD). |
projectId | string | Only this project. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/projects \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"today":"2026-10-16"}'
Response 200: Active rehab projects with budget, spend and variance, plus overdue project tasks.
{
"projects": [
{
"id": "proj_123",
"name": "Maple St rehab",
"status": "in_progress",
"targetDate": "2026-12-15",
"currentBudget": 125000,
"actualSpent": 118400,
"budgetVariancePct": -5.3,
"overVarianceThreshold": false
}
],
"totalProjects": 1,
"varianceThresholdPct": 10,
"projectsTruncated": false,
"overdueTasks": [
{
"id": "ptask_123",
"projectId": "proj_123",
"title": "Schedule framing inspection",
"dueDate": "2026-10-09",
"assignee": "rep_123"
}
],
"overdueTasksTruncated": false
}
Property book
POST/api/agent-gateway/properties
Rental properties with tenants, rent status, leases and open maintenance.
Scopes: projects_properties:read
MCP tool: list_properties
| Field | Type | About |
|---|
today (required) | string | Today's date in the account's time zone (YYYY-MM-DD). |
curl -X POST https://syntropic-crm.com/api/agent-gateway/properties \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"today":"2026-10-16"}'
Response 200: Open work orders, leases ending soon, unpaid rent and vacant units.
{
"today": "2026-10-16",
"capped": false,
"openWorkOrders": [
{
"id": "wo_123",
"title": "Replace HVAC capacitor",
"status": "open",
"priority": "high",
"dueDate": "2026-10-18"
}
],
"leasesEnding": [
{
"id": "lease_123",
"unitId": "unit_123",
"endDate": "2026-11-10",
"rent": 1450
}
],
"unpaidRent": [
{
"id": "rent_123",
"leaseId": "lease_123",
"period": "2026-10",
"dueDate": "2026-10-01",
"balance": 1450,
"overdue": true
}
],
"vacancies": [
{
"id": "unit_456",
"label": "Unit 2B",
"propertyId": "prop_123",
"marketRent": 1500
}
]
}
Draw schedule
POST/api/agent-gateway/project-drawsop read
Lender draw schedules on rehab projects, or one project's schedule.
Scopes: projects_properties:read
MCP tool: read_draw_schedule
| Field | Type | About |
|---|
op (required) | "read" | |
projectId | string | Only this project. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/project-draws \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"read","projectId":"<projectId>"}'
Response 200: The draw schedule for active projects, with draws that are behind.
{
"today": "2026-10-16",
"projects": [
{
"id": "proj_123",
"name": "Maple St rehab",
"status": "in_progress",
"spent": 64500,
"scheduledTotal": 90000,
"releasedTotal": 45000,
"behindCount": 1,
"draws": [
{
"id": "draw_123",
"name": "Draw 2 - rough-in",
"amount": 22500,
"status": "approved",
"scheduledDate": "2026-10-09",
"releasedDate": null,
"daysBehind": 7,
"fundingSource": {
"id": "fund_123",
"lender": "Lakeside Capital",
"status": "committed"
}
}
]
}
],
"projectsWithoutDraws": [
{
"id": "proj_456",
"name": "Oak Ct flip"
}
],
"behindSchedule": [
{
"projectId": "proj_123",
"projectName": "Maple St rehab",
"drawId": "draw_123",
"drawName": "Draw 2 - rough-in",
"amount": 22500,
"status": "approved",
"daysBehind": 7
}
],
"projectsTruncated": false,
"notFound": false
}
Tasks
List reminders
POST/api/agent-gateway/remindersop list
The rep's open or done reminders.
Scopes: tasks:read
MCP tool: list_reminders
| Field | Type | About |
|---|
op (required) | "list" | |
status | "open" | "done" | |
curl -X POST https://syntropic-crm.com/api/agent-gateway/reminders \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"list","status":"open"}'
Response 200: The teammate's reminders, in the account's time zone. more is true when there are more.
{
"timezone": "America/Chicago",
"reminders": [
{
"id": "rem_123",
"text": "Call Jordan Smith back about the offer",
"dueDate": "2026-10-16",
"dueTime": "14:00",
"status": "open",
"record": {
"kind": "lead",
"label": "Jordan Smith"
}
}
],
"more": false
}
Create a reminder
POST/api/agent-gateway/remindersop createChanges data
Set a reminder for the rep at a date and time in the account's time zone, optionally on a lead, transaction or dispo deal.
Scopes: tasks:write
MCP tool: create_reminder
| Field | Type | About |
|---|
op (required) | "create" | |
text (required) | string | What the reminder is for. |
dueDate (required) | string | Due date (YYYY-MM-DD). |
dueTime (required) | string | Due time, 24-hour HH:MM. |
record | object | |
record.kind (required in record) | "lead" | "transaction" | "dispo_deal" | |
record.id (required in record) | string | The record's id. Up to 64 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/reminders \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"create","text":"Call Dana back about the offer","dueDate":"2026-10-17","dueTime":"14:30","record":{"kind":"lead","id":"<leadId>"}}'
Response 200: The new reminder's id. deduped is true when it matched an open reminder instead.
{
"id": "rem_124",
"deduped": false,
"timezone": "America/Chicago"
}
List a lead's tasks
POST/api/agent-gateway/lead-tasksop list
The open or done tasks on one lead, with their ids for completing them.
Scopes: tasks:read, leads:read
MCP tool: list_lead_tasks
| Field | Type | About |
|---|
op (required) | "list" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
status | "open" | "done" | |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-tasks \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"list","leadId":"<leadId>","status":"open"}'
Response 200: The lead's tasks.
{
"leadId": "lead_123",
"tasks": [
{
"id": "task_301",
"title": "Send seller the comps",
"dueDate": "2026-10-16",
"dueTime": "10:30",
"done": false,
"assigneeRepId": "rep_123",
"repeats": false
}
],
"truncated": false
}
Create a task on a lead
POST/api/agent-gateway/lead-tasksop createChanges data
Add a follow-up task to a lead, for the key's rep or another active teammate, with an optional due date and time.
Scopes: tasks:write, leads:read
MCP tool: create_lead_task
| Field | Type | About |
|---|
op (required) | "create" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
title (required) | string | What needs doing. Up to 300 characters. |
dueDate | string | Due date (YYYY-MM-DD). |
dueTime | string | Due time, 24-hour HH:MM. Needs a dueDate. |
assigneeRepId | string | The teammate's rep id. Defaults to the key's rep. Up to 64 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-tasks \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"create","leadId":"<leadId>","title":"Send the seller the comps","dueDate":"2026-10-17","dueTime":"10:30"}'
Response 200: The new task.
{
"leadId": "lead_123",
"task": {
"id": "task_302",
"title": "Call seller about the roof estimate",
"dueDate": "2026-10-17",
"dueTime": "09:00",
"done": false,
"assigneeRepId": "rep_123",
"repeats": false
}
}
Complete a task on a lead
POST/api/agent-gateway/lead-tasksop completeChanges data
Mark a task on a lead done. The rep must own the task, unless they're an owner or admin.
Scopes: tasks:write, leads:read
MCP tool: complete_lead_task
| Field | Type | About |
|---|
op (required) | "complete" | |
taskId (required) | string | The task's id. Up to 64 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/lead-tasks \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"complete","taskId":"<taskId>"}'
Response 200: The task, now done. alreadyDone is true when it was done before.
{
"task": {
"id": "task_302",
"title": "Call seller about the roof estimate",
"dueDate": "2026-10-17",
"dueTime": "09:00",
"done": true,
"assigneeRepId": "rep_123",
"repeats": false
},
"alreadyDone": false
}
Calls
Recent calls
POST/api/agent-gateway/calls
Recorded or connected calls the key's rep can open, newest first. Without from, until or cursor: the latest, at most 15. With from and/or until (epoch ms, or YYYY-MM-DD in the account's time zone, until exclusive / through that day): pages of up to limit checked calls with nextCursor; a page can be empty while nextCursor has more, and nextCursor is null when done.
Scopes: calls:read. The key's teammate must see the whole book.
MCP tool: list_calls
| Field | Type | About |
|---|
limit | integer | How many calls to return. 1 to 50. |
from | any | Epoch ms, or YYYY-MM-DD in the account's time zone. |
until | any | Epoch ms, or YYYY-MM-DD in the account's time zone. |
cursor | string | The nextCursor from the previous page. Up to 8,192 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/calls \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"from":"2026-10-26","until":"2026-11-01","limit":50}'
Response 200: Calls with a summary or a connected outcome that the key's rep can open, newest first. Without from, until or cursor: the latest, at most 15, and moreCalls says more exist. With from and/or until: one page of up to limit calls from the window, with nextCursor to send back for the next page and window holding the resolved bounds in epoch ms. A page can have no calls while nextCursor still has more; nextCursor is null when nothing is left. truncated is true when some calls couldn't be checked in this call and were left out. pendingCalls counts calls whose time is still being settled; they show on a later walk.
{
"calls": [
{
"id": "call_123",
"occurredAt": 1793196000000,
"direction": "outbound",
"outcome": "connected",
"durationSeconds": 412,
"leadId": "lead_123",
"party": "Jordan Smith",
"recordingFetchable": true,
"summary": "Seller open to a cash offer in the low $160s if it closes in 30 days."
}
],
"moreCalls": true,
"gradesTruncated": false,
"scanned": 50,
"excerptChars": 400,
"nextCursor": "c1:1792987200000:1793595600000:eyJvIjoxNzkyMTU5MjAwMDAwfQ",
"truncated": false,
"window": {
"from": 1792987200000,
"until": 1793595600000
}
}
Get a call's recording
POST/api/agent-gateway/call-recording
The audio of one call from Recent calls, streamed with the API key. Checks the key's rep can open that call on every request; never returns a link. Only calls with recordingFetchable true can be downloaded. Over MCP, recordings up to 3 MB come back as audio; larger ones must use REST.
Scopes: calls:read. The key's teammate must see the whole book.
MCP tool: get_call_recording
| Field | Type | About |
|---|
callId (required) | string | The call's id, from Recent calls. Up to 64 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/call-recording \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"callId":"call_123"}'
Response 200: The recording's audio bytes (audio/mpeg or the stored type), as a download.
null
Place a call
POST/api/agent-gateway/commsop callChanges data
Ring the rep's phone, then connect it to a number on the lead. Do-not-call and calling hours always apply.
Scopes: calls:send, leads:read
MCP tool: place_call
| Field | Type | About |
|---|
op (required) | "call" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
to (required) | string | A phone number on that lead. Up to 254 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/comms \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"call","leadId":"<leadId>","to":"+15555550123"}'
Response 200: The call was placed. logged is true when it's on the lead's call log.
{
"ok": true,
"op": "call",
"leadId": "lead_123",
"to": "+15555550123",
"logged": true,
"callLogId": "call_456",
"from": "+15555550199",
"providerId": "twilio"
}
Log a call
POST/api/agent-gateway/call-logChanges data
Record a call the rep already made on a lead, with its outcome and notes. It shows on the lead's timeline and counts like a call logged in the app. Nothing is dialed.
Scopes: calls:write, leads:read
MCP tool: log_call
| Field | Type | About |
|---|
leadId (required) | string | The lead's id. Up to 64 characters. |
outcome (required) | string | The call outcome: one of the account's call dispositions, by key or label (for example no_answer, voicemail, connected). Up to 120 characters. |
notes | string | What was said. Up to 5,000 characters. |
phone | string | The number called. It must be on the lead, unless the outcome is a Do Not Call disposition. Up to 40 characters. |
occurredAt | string | When the call happened, as an ISO 8601 date-time with Z or an offset (2026-10-16T14:30:00Z). Defaults to now; at most a year back. Up to 40 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/call-log \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"leadId":"<leadId>","outcome":"no_answer","notes":"Left a voicemail about the offer.","phone":"+15555550123","occurredAt":"2026-10-16T14:30:00Z"}'
Response 200: The logged call's id, the lead, the outcome and disposition it was saved with, and when it happened.
{
"callId": "call_789",
"leadId": "lead_123",
"outcome": "no_answer",
"disposition": "No answer",
"occurredAt": 1792161000000
}
Texts
Send a text
POST/api/agent-gateway/commsop textChanges data
Text a number on the lead from the rep's line. Do-not-text, opt-outs and calling hours always apply.
Scopes: texts:send, leads:read
MCP tool: send_text
| Field | Type | About |
|---|
op (required) | "text" | |
leadId (required) | string | The lead's id. Up to 64 characters. |
to (required) | string | A phone number on that lead. Up to 254 characters. |
body (required) | string | The message. Up to 20,000 characters. |
from | string | Optional. A line this key's teammate may send from, in E.164 (+15555550123). Omit for the usual number. Up to 16 characters, matches ^\+[1-9]\d{7,14}$. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/comms \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"text","leadId":"<leadId>","to":"+15555550123","body":"Hi Dana, this is Jordan. Is now a good time to talk about the house?","from":"+15555550199"}'
Response 200: The text was sent. logged is true when it's on the lead's timeline. With from, the text goes from that line or is refused.
{
"ok": true,
"op": "text",
"leadId": "lead_123",
"to": "+15555550123",
"logged": true,
"from": "+15555550199",
"providerId": "twilio"
}
Read a text thread
POST/api/agent-gateway/text-thread
The texts with a lead or contact the rep can see, newest first, one page at a time. Numbers and names on records the rep can see are shown in full, as in the app. A text that also belongs to a lead or contact the rep can't see is left out and counted in omitted.
Scopes: texts:read, leads:read
MCP tool: read_text_thread
| Field | Type | About |
|---|
leadId | string | The lead's id. Send this or contactId. Up to 64 characters. |
contactId | string | A contact's id. Send this or leadId. Up to 64 characters. |
cursor | string | The cursor from the previous page, to read further back. Up to 4,000 characters. |
limit | integer | How many messages to return. 1 to 50. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/text-thread \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"leadId":"<leadId>","limit":20}'
Response 200: One page of texts, newest first. omitted counts texts left out because they also belong to a record the rep can't see; read on while cursor is set.
{
"omitted": 0,
"texts": [
{
"id": "sms_456",
"direction": "inbound",
"body": "Yes, still interested. Call me after 5.",
"status": "received",
"at": 1792159500000,
"phone": "+15555550123",
"contactName": "Dana Whitfield",
"leadId": "lead_123"
}
],
"cursor": "<cursor>",
"isDone": false
}
Analysis
Underwrite a lead
POST/api/agent-gateway/underwrite-lead
Run the Deal Analyzer on a lead's saved property facts, with optional overrides, and return MAO and offer guidance.
Scopes: analysis:read, leads:read
MCP tool: underwrite_lead
Cost: 1 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
leadId (required) | string | The lead's id. |
purchasePrice | number | Purchase price to test ($) At least 0. |
repairCost | number | Lump-sum repair estimate ($) At least 0. |
repairQuantities | object | Itemized repair scope: cheat-sheet item key to quantity. |
repairQuantities.<key> | number | Any key. At least 0. |
holdMonths | number | Hold time in months. At least 0. |
maoRulePct | number | MAO rule as % of ARV. 0 to 100. |
wholesaleFee | number | Wholesale fee ($) At least 0. |
desiredProfit | number | Desired profit in dollars, used when the account's MAO formula includes it. Don't send with desiredProfitPct. 0 to 10000000. |
desiredProfitPct | number | Desired profit as a percent of ARV, used when the account's MAO formula includes it. Don't send with desiredProfit. 0 to 100. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/underwrite-lead \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"leadId":"<leadId>","purchasePrice":140000,"repairQuantities":{"paint_interior":1,"flooring":1200}}'
Response 200: The Deal Analyzer result using an ARV from approved comps. status can also be needs_review or no_data, with a message.
{
"status": "ok",
"brief": "DEAL ANALYZER — engine output (formula (ARV * percentage) - repairs - wholesaleFee, 70% · fee $0, 4 mo hold)\nInputs: ARV $265,056 · Purchase $140,000 · Repairs $32,000\nMAO: $153,539\nOpening offer: $138,000 · Walk-away: $153,500 …",
"result": {
"mao": 153539,
"openingOffer": 138000,
"walkAway": 153500,
"netProfit": 76856,
"roiTotalCosts": 0.408,
"cashAtClosing": 142030,
"committedCapital": 175230,
"totalCosts": 188200
},
"profitAtOffer": {
"offer": 140000,
"netProfit": 76856,
"roiTotalCosts": 0.408,
"roiPurchaseRehab": 0.447
},
"arv": 265056,
"perSqft": 176,
"compsUsed": [
{
"address": "418 Maple Ave",
"soldPrice": 262000,
"soldDate": "2026-08-14",
"pricePerSqft": 178
}
]
}
Deal Analyzer
POST/api/agent-gateway/deal-analyzer
MAO, opening offer and walk-away from the account's saved deal defaults and offer rules.
Scopes: analysis:read
MCP tool: analyze_deal
Cost: 1 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
arv (required) | number | After-repair value ($) At least 0. |
purchasePrice | number | Purchase price ($) At least 0. |
repairCost | number | Lump-sum repair estimate ($) At least 0. |
repairQuantities | object | Itemized repair scope: cheat-sheet item key to quantity. |
repairQuantities.<key> | number | Any key. At least 0. |
holdMonths | number | Hold time in months. At least 0. |
sqft | number | Living area in square feet. At least 0. |
liens | object[] | Financing on the deal, up to 5 liens. |
liens[].label | string | A name for the lien. Up to 60 characters. |
liens[].amountPct (required in liens) | number | Loan amount as % of the cost basis. 0 to 100. |
liens[].points | number | Points and lender fees ($) At least 0. |
liens[].ratePct (required in liens) | number | Annual interest rate (%). 0 to 50. |
maoRulePct | number | MAO rule as % of ARV. 0 to 100. |
wholesaleFee | number | Wholesale fee ($) At least 0. |
desiredProfit | number | Desired profit in dollars, used when the account's MAO formula includes it. Don't send with desiredProfitPct. 0 to 10000000. |
desiredProfitPct | number | Desired profit as a percent of ARV, used when the account's MAO formula includes it. Don't send with desiredProfit. 0 to 100. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/deal-analyzer \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"arv":265000,"purchasePrice":140000,"repairCost":32000,"holdMonths":4,"liens":[{"label":"Hard money","amountPct":90,"points":2000,"ratePct":12}]}'
Response 200: The Deal Analyzer brief and numbers: MAO, opening offer, walk-away, profit and costs.
{
"brief": "DEAL ANALYZER — engine output (formula (ARV * percentage) - repairs - wholesaleFee, 70% · fee $0, 4 mo hold)\nInputs: ARV $265,000 · Purchase $140,000 · Repairs $32,000\nMAO: $153,500\nOpening offer: $138,000 · Walk-away: $153,500 …",
"result": {
"mao": 153500,
"openingOffer": 138000,
"walkAway": 153500,
"netProfit": 76802,
"roiTotalCosts": 0.408,
"cashAtClosing": 142030,
"committedCapital": 175230,
"totalCosts": 188198
},
"profitAtOffer": {
"offer": 140000,
"netProfit": 76802,
"roiTotalCosts": 0.408,
"roiPurchaseRehab": 0.447
}
}
Stress test
POST/api/agent-gateway/stress-underwrite
The base case plus ARV -5%, rehab +15%, timeline +2 months and all three, with MAO, profit and ROI for each.
Scopes: analysis:read
MCP tool: stress_underwrite
Cost: 1 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
arv (required) | number | After-repair value ($) At least 0. |
purchasePrice | number | Purchase price ($) At least 0. |
repairCost | number | Lump-sum repair estimate ($) At least 0. |
repairQuantities | object | Itemized repair scope: cheat-sheet item key to quantity. |
repairQuantities.<key> | number | Any key. At least 0. |
holdMonths | number | Hold time in months. At least 0. |
sqft | number | Living area in square feet. At least 0. |
liens | object[] | Financing on the deal, up to 5 liens. |
liens[].label | string | A name for the lien. Up to 60 characters. |
liens[].amountPct (required in liens) | number | Loan amount as % of the cost basis. 0 to 100. |
liens[].points | number | Points and lender fees ($) At least 0. |
liens[].ratePct (required in liens) | number | Annual interest rate (%). 0 to 50. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/stress-underwrite \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"arv":265000,"purchasePrice":140000,"repairCost":32000,"holdMonths":4}'
Response 200: The deal under five stress cases, with a one-line verdict.
{
"scenarios": [
{
"label": "Base case",
"arv": 265000,
"repairCost": 32000,
"holdMonths": 4,
"mao": 153500,
"netProfit": 56400,
"roiTotalCosts": 0.286
}
],
"verdict": "Holds a profit in every stress case.",
"brief": "STRESS-TESTED UNDERWRITE — engine output (each row is a full Deal Analyzer run)\nPurchase $140,000\n- Base case: ARV $265,000 · repairs $32,000 · 4 mo hold → MAO $153,500 · net profit $56,400 · ROI 28.60% …"
}
Rehab estimate
POST/api/agent-gateway/rehab-estimate
Price an itemized repair scope with the account's unit costs.
Scopes: analysis:read
MCP tool: estimate_rehab
Cost: 1 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
repairQuantities (required) | object | Itemized repair scope: cheat-sheet item key to quantity. |
repairQuantities.<key> | number | Any key. At least 0. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/rehab-estimate \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"repairQuantities":{"paint_interior":1,"flooring":1200,"water_heater":1}}'
Response 200: A priced rehab estimate from the account's cost sheet, with contingency.
{
"lines": [
{
"key": "paint_interior",
"label": "Interior paint",
"unit": "lump",
"unitCost": 3000,
"qty": 1,
"lineTotal": 3000,
"accountCost": false
}
],
"subtotal": 3000,
"contingencyPct": 15,
"contingency": 450,
"total": 3450,
"unknownKeys": [],
"invalidKeys": [],
"brief": "REHAB ESTIMATE — engine output from the account's reno cost cheat sheet\n- Interior paint [paint_interior]: 1 lump × $3,000 = $3,000 (default unit cost; the account has not set one)\nSubtotal $3,000 + 15% contingency ($450) = $3,450\nPass these same quantities as repairQuantities to run_deal_analyzer or run_stress_underwrite so the offer math prices the identical scope."
}
Creative finance
POST/api/agent-gateway/creative-finance
Price a seller-finance, subject-to or hybrid deal: entry cost, payments, spread and balloon exposure, with an optional cash comparison.
Scopes: analysis:read
MCP tool: creative_finance
Cost: 1 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
price (required) | number | Purchase price on terms ($) At least 0. |
downPayment (required) | number | Down payment to the seller ($) At least 0. |
ratePct | number | Seller-note interest rate (annual %). At least 0. |
termMonths | integer | Seller-note amortization in months. 1 to 480. |
exit (required) | "rent" | "resale" | How the deal exits. |
monthlyRent | number | Rent exit: monthly rent ($) At least 0. |
resalePrice | number | Resale exit: sale price ($) At least 0. |
arv | number | ARV for the cash-offer comparison ($) At least 0. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/creative-finance \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"price":210000,"downPayment":10000,"ratePct":5,"termMonths":360,"exit":"rent","monthlyRent":1800,"arv":240000}'
Response 200: The terms deal next to the cash offer. status is invalid, with a message, when the inputs don't work.
{
"status": "ok",
"brief": "Creative finance (seller finance, rent exit): $10,000 entry · $1,449/mo PITI · $171/mo net spread …",
"result": {
"sellerCarry": 200000,
"entryCost": 10000,
"notePayment": 1199,
"monthlyPiti": 1449,
"horizonMonths": 60,
"balloon": null,
"rent": {
"monthlyRent": 1800,
"grossSpread": 351,
"vacancyPct": 5,
"maintenancePct": 5,
"reserves": 180,
"netSpread": 171,
"annualCashFlow": 2052,
"monthsToRecoverEntry": 59
},
"resale": null
},
"comparison": {
"cash": {
"mao": 153500,
"openingOffer": 142000,
"walkAway": 148000,
"price": 148000,
"cashAtClosing": 144200,
"netProfit": 56400,
"holdMonths": 4
},
"terms": {
"price": 210000,
"entryCost": 10000,
"monthlyPiti": 1449,
"monthlySpread": 171,
"projectedProfit": null,
"annualCashFlow": 2052,
"balloonDue": null,
"monthsToProfit": 59
},
"priceAboveWalkAway": 62000,
"entrySavedVsCash": 134200
}
}
Underwrite a property
POST/api/agent-gateway/comps-underwriteop run
Start a full underwrite of a lead or an address: comps, ARV, as-is value, repairs and offers. Answers at once with a runId; get the result in 1-3 minutes from comps-underwrite.get. 100 AI credits, charged only if the run finishes ok.
Scopes: analysis:read, leads:read
MCP tool: underwrite_property
Cost: 100 AI credit per successful run, from the account's balance (see AI credits).
| Field | Type | About |
|---|
op (required) | "run" | |
leadId | string | The lead's id. Give leadId or address, not both. Up to 120 characters. |
address | string | One-line property address, if there is no lead. Up to 200 characters. |
rerun | boolean | Make a new, charged run even if a fresh one exists. |
idempotencyKey | string | Retries with the same key and body return the same run. Up to 100 characters. |
compCount | integer | Comps to value with. Default: the account setting. 4 to 12. |
facts | object | Subject facts for this run; they win over the lead's. |
facts.beds | integer | Bedrooms. 0 to 20. |
facts.baths | integer | Full baths. 0 to 20. |
facts.halfBaths | integer | Half baths. 0 to 10. |
facts.sqft | integer | Living area in square feet. 200 to 20000. |
facts.yearBuilt | integer | Year built. At least 1800. |
facts.lotSqft | integer | Lot size in square feet. 0 to 10000000. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/comps-underwrite \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"op":"run","leadId":"<leadId>"}'
curl -X POST https://syntropic-crm.com/api/agent-gateway/comps-underwrite \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Idempotency-Key: <unique-id-per-run>" \
-H "Content-Type: application/json" \
-d '{"op":"run","address":"123 Main St, Springfield, IL 62701","compCount":8,"facts":{"sqft":1450}}'
Response 200: The run started. Poll comps-underwrite.get every 10 seconds; a run finishes within 3 minutes.
{
"runId": "run_123",
"status": "queued",
"reused": false
}
Get an underwrite
POST/api/agent-gateway/comps-underwriteop get
The status and, once finished, the result of an underwrite run. Free.
Scopes: analysis:read, leads:read
MCP tool: get_property_underwrite
| Field | Type | About |
|---|
op (required) | "get" | |
runId (required) | string | The underwrite run's id. Up to 120 characters. |
curl -X POST https://syntropic-crm.com/api/agent-gateway/comps-underwrite \
-H "Authorization: Bearer $SYNTROPIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"op":"get","runId":"<runId>"}'
Response 200: status is queued, running, ok, thin_comps, no_data or error. result is set for ok and thin_comps; error says why otherwise. Only ok is charged. Comps from sources we can't show appear as Comp <n>, with our values only.
{
"runId": "uw_ok_run",
"status": "ok",
"leadId": "lead",
"address": "1 Subject St, Austin, TX 78701",
"createdAt": "2026-11-09T12:00:00.000Z",
"finishedAt": "2026-11-09T12:00:40.000Z",
"error": null,
"result": {
"engineVersion": 1,
"version": 1,
"arv": {
"point": 245000,
"low": 237700,
"high": 252400
},
"asIs": {
"point": 150000,
"low": 135000,
"high": 165000
},
"confidence": 0.88,
"sides": {
"arv": {
"usable": 4,
"confidence": 0.88,
"basis": "sold",
"confidenceCapped": false,
"dropped": []
},
"cmv": {
"usable": 2,
"confidence": 0.63,
"basis": "list",
"confidenceCapped": false,
"dropped": []
}
},
"subject": {
"saleHistory": [],
"landUse": {
"value": "single_family",
"source": "vendor"
},
"beds": {
"value": 3,
"source": "vendor"
},
"baths": {
"value": 2,
"source": "vendor"
},
"sqft": {
"value": 1500,
"source": "vendor"
},
"yearBuilt": {
"value": 1990,
"source": "vendor"
}
},
"overrides": null,
"comps": [
{
"key": "r:1",
"label": "101 Elm St, Austin, TX 78701",
"sourceHidden": false,
"source": "rentcast",
"address": "101 Elm St, Austin, TX 78701",
"price": 160000,
"date": "2026-09-09",
"dateLabel": "Listed",
"priceBasis": "list",
"saleMatched": true,
"adjustments": [],
"compType": "arv",
"denied": false,
"distanceMi": 0.1,
"conditionBand": "updated",
"renovationScore": 0.85,
"conditionAdvisory": false,
"similarity": 0.9555,
"adjustedValue": 245000,
"weight": 0.2818,
"beds": 3,
"baths": 2,
"sqft": 1500,
"yearBuilt": 1990,
"dom": 30,
"listPrice": 160000,
"landUse": "single_family"
},
{
"key": "r:2",
"label": "Comp 2",
"sourceHidden": true,
"adjustments": [],
"compType": "arv",
"denied": false,
"distanceMi": 0.2,
"conditionBand": "updated",
"renovationScore": 0.85,
"conditionAdvisory": false,
"similarity": 0.9405,
"adjustedValue": 245000,
"weight": 0.2583
},
{
"key": "r:3",
"label": "103 Elm St, Austin, TX 78701",
"sourceHidden": false,
"source": "rentcast",
"address": "103 Elm St, Austin, TX 78701",
"price": 160000,
"date": "2026-09-09",
"dateLabel": "Listed",
"priceBasis": "list",
"saleMatched": true,
"adjustments": [],
"compType": "arv",
"denied": false,
"distanceMi": 0.3,
"conditionBand": "updated",
"renovationScore": 0.85,
"conditionAdvisory": false,
"similarity": 0.9255,
"adjustedValue": 245000,
"weight": 0.2385,
"beds": 3,
"baths": 2,
"sqft": 1500,
"yearBuilt": 1990,
"dom": 30,
"listPrice": 160000,
"landUse": "single_family"
},
{
"key": "r:4",
"label": "100 Oak Dr, Austin, TX 78701",
"sourceHidden": false,
"source": "rentcast",
"address": "100 Oak Dr, Austin, TX 78701",
"price": 160000,
"date": "2026-09-09",
"dateLabel": "Listed",
"priceBasis": "list",
"saleMatched": true,
"adjustments": [],
"compType": "arv",
"denied": false,
"distanceMi": 0.4,
"conditionBand": "updated",
"renovationScore": 0.85,
"conditionAdvisory": false,
"similarity": 0.9105,
"adjustedValue": 245000,
"weight": 0.2214,
"beds": 3,
"baths": 2,
"sqft": 1500,
"yearBuilt": 1990,
"dom": 30,
"listPrice": 160000,
"landUse": "single_family"
},
{
"key": "r:5",
"label": "105 Elm St, Austin, TX 78701",
"sourceHidden": false,
"source": "rentcast",
"address": "105 Elm St, Austin, TX 78701",
"price": 154639,
"date": "2026-09-09",
"dateLabel": "Listed",
"priceBasis": "list",
"saleMatched": false,
"adjustments": [
{
"key": "listing_to_sale",
"amount": 4639
}
],
"compType": "cmv",
"denied": false,
"distanceMi": 0.5,
"conditionBand": "as_is",
"renovationScore": 0.5,
"conditionAdvisory": true,
"similarity": 0.9028,
"adjustedValue": 150000,
"weight": 0.5161,
"beds": 3,
"baths": 2,
"sqft": 1500,
"yearBuilt": 1990,
"dom": 30,
"listPrice": 154639,
"landUse": "single_family"
},
{
"key": "r:6",
"label": "106 Elm St, Austin, TX 78701",
"sourceHidden": false,
"source": "rentcast",
"address": "106 Elm St, Austin, TX 78701",
"price": 154639,
"date": "2026-09-09",
"dateLabel": "Listed",
"priceBasis": "list",
"saleMatched": false,
"adjustments": [
{
"key": "listing_to_sale",
"amount": 4639
}
],
"compType": "cmv",
"denied": false,
"distanceMi": 0.6,
"conditionBand": "as_is",
"renovationScore": 0.5,
"conditionAdvisory": true,
"similarity": 0.8878,
"adjustedValue": 150000,
"weight": 0.4839,
"beds": 3,
"baths": 2,
"sqft": 1500,
"yearBuilt": 1990,
"dom": 30,
"listPrice": 154639,
"landUse": "single_family"
}
],
"rehab": {
"byTrade": [
{
"trade": "roof",
"subtotal": 35000
}
],
"lines": [
{
"label": "Roof",
"qty": 1,
"unitCost": 35000,
"cost": 35000,
"trade": "roof",
"description": "Replace the roof",
"key": "roof"
}
],
"subtotal": 35000,
"contingencyPct": 10,
"contingency": 3500,
"total": 38500
},
"offers": {
"monthlyHolding": 0,
"totalHolding": 0,
"totalBuying": 1400,
"titleCost": 500,
"totalSelling": 13344,
"realtorCost": 9800,
"transferCost": 294,
"financingPoints": 0,
"financingInterest": 0,
"totalFinancing": 0,
"lienProceeds": 0,
"netProfit": 191756,
"roiTotalCosts": 3.6014574412140337,
"roiPurchaseRehab": 4.980675324675325,
"costPerSqft": null,
"cashAtClosing": 1400,
"committedCapital": 41100,
"cashOnCashAnnual": 13.996788321167884,
"mao": 128000,
"openingOffer": 115000,
"walkAway": 128000,
"totalCosts": 53244
},
"reasoning": "Four recorded sales within 0.4 miles support the ARV; two list-only comps set the as-is value.",
"vendorAvms": [],
"warnings": [],
"nonDisclosure": true,
"sourceLabel": "listed sales only"
}
}