Developers

REST reference

Every endpoint an API key can call. Anything not listed here refuses keys.

Your key

Who am I

POST/api/agent-gateway/whoami

The rep this key acts as, and the key's name, scopes and approval setting.

Scopes: any working key
MCP tool: whoami

No fields. Send an empty body or {}.

curl -X POST https://syntropic-crm.com/api/agent-gateway/whoami \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response 200: The teammate the key acts as, and the key's name, scopes and approval setting.

{
  "rep": {
    "id": "rep_123",
    "accountId": "acct_123",
    "fullName": "Jordan Smith",
    "accessRole": "rep",
    "jobRole": "acquisitions"
  },
  "key": {
    "name": "Intake assistant",
    "scopes": [
      {
        "area": "leads",
        "level": "read"
      }
    ],
    "needsApproval": false
  }
}

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

FieldTypeAbout
stagestringOnly leads in this pipeline stage.
ownerRepIdstringOnly leads owned by this rep id.
untouchedDaysintegerOnly leads with no activity for at least this many days. At least 0.
limitintegerHow many leads to return. 1 to 200.
cursorstring"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

FieldTypeAbout
op (required)"get"
leadId (required)stringThe 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

FieldTypeAbout
op (required)"find"
namestringPart of the seller's or company's name (2+ characters). Up to 120 characters.
phonestringA phone number in any format. Up to 120 characters.
addressstringPart of the property address (2+ characters). Up to 120 characters.
limitintegerHow 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

FieldTypeAbout
op (required)"create"
contactNamestringThe seller's name. Give this or an address. Up to 200 characters.
companyNamestringThe seller's company. Up to 200 characters.
phonestringThe seller's phone number. Up to 200 characters.
extensionstringAn 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.
emailstringThe seller's email address. Up to 200 characters.
addressstringThe property address. Up to 200 characters.
valuenumberThe deal value in dollars. At least 0.
sourcestringWhere the lead came from, as a marketing channel name. Up to 200 characters.
stagestringThe stage key or name to start in. Defaults to the pipeline's first open stage. Up to 200 characters.
allowDuplicatebooleanCreate 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

FieldTypeAbout
op (required)"update"
leadId (required)stringThe lead's id. Up to 64 characters.
contactNamestringThe seller's name. Up to 200 characters.
companyNamestringThe seller's company. Up to 200 characters.
phoneanyThe seller's phone number. Send null to clear it.
extensionanyAn 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.
emailanyThe seller's email address. Send null to clear it.
addressanyThe property address. Send null to clear it.
valueanyThe deal value in dollars. Send null to clear it.
sourceanyThe marketing channel name. Send null to clear it.
fieldsobjectLead 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>anyThe 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

FieldTypeAbout
op (required)"stage"
leadId (required)stringThe lead's id. Up to 64 characters.
stage (required)stringThe stage key or name. Up to 200 characters.
lostReasonstringWhy 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

FieldTypeAbout
op (required)"note"
leadId (required)stringThe lead's id. Up to 64 characters.
body (required)stringThe 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

FieldTypeAbout
op (required)"tag"
leadId (required)stringThe lead's id. Up to 64 characters.
tag (required)stringThe tag's label. Up to 40 characters.
removebooleanRemove 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
}

Deals & offers

List open offers

POST/api/agent-gateway/offers

The account's open offers on seller leads, with amounts, status and follow-up dates.

Scopes: deals_offers:read. The key's teammate must see the whole book.
MCP tool: list_offers

FieldTypeAbout
limitintegerHow many offers to return. 1 to 200.
curl -X POST https://syntropic-crm.com/api/agent-gateway/offers \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":50}'

Response 200: The account's open offers: submitted, negotiating or countered.

{
  "offers": [
    {
      "id": "offer_456",
      "leadId": "lead_123",
      "leadName": "Dana Whitfield",
      "amount": 150000,
      "counterAmount": 162500,
      "round": 2,
      "status": "countered",
      "offeredAt": 1792141920000
    }
  ],
  "truncated": false
}

Offer history

POST/api/agent-gateway/offer-history

Offers made over a past window, optionally filtered by status.

Scopes: deals_offers:read. The key's teammate must see the whole book.
MCP tool: offer_history

FieldTypeAbout
sinceDaysnumberHow many days back to look. At least 1.
statusstringOnly offers with this status.
limitintegerHow many offers to return. 1 to 200.
curl -X POST https://syntropic-crm.com/api/agent-gateway/offer-history \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sinceDays":90,"limit":50}'

Response 200: Offers made in the window, with counts by status and win rates by ARV band, ask ratio and source.

{
  "sinceDays": 90,
  "windowStart": 1784386800000,
  "made": 6,
  "answered": 4,
  "stillOpen": 1,
  "byStatus": [
    {
      "status": "rejected",
      "count": 3
    }
  ],
  "scanTruncated": false,
  "offers": [
    {
      "id": "offer_789",
      "leadName": "Sam Carter",
      "amount": 142000,
      "offerType": "cash",
      "status": "rejected",
      "outcome": "lost",
      "pctOfArv": 72.4,
      "offeredAt": 1792141920000
    }
  ],
  "offersTruncated": false,
  "analysisScanTruncated": false,
  "winRates": {
    "decided": 3,
    "won": 1,
    "lost": 2,
    "winRatePct": 33,
    "byArvBand": [
      {
        "band": "70–75% of ARV",
        "won": 1,
        "lost": 1,
        "winRatePct": 50
      }
    ],
    "noArv": 1,
    "byAskRatio": [
      {
        "band": "80–90% of ask",
        "won": 1,
        "lost": 2,
        "winRatePct": 33
      }
    ],
    "noAsk": 0,
    "bySource": [
      {
        "band": "Direct mail",
        "won": 1,
        "lost": 2,
        "winRatePct": 33
      }
    ],
    "sourcesTruncated": false
  }
}

Dispo

Dispo deal book

POST/api/agent-gateway/dispo

The deals on the Dispo desk with their stage, asking price, buyer interest and blast activity.

Scopes: dispo:read
MCP tool: list_dispo_deals

No fields. Send an empty body or {}.

curl -X POST https://syntropic-crm.com/api/agent-gateway/dispo \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response 200: Open dispo deals, the buyer list and buyer lists, with flags when a list was capped.

{
  "deals": [
    {
      "id": "deal_123",
      "propertyAddress": "123 Main St, Springfield, IL 62701",
      "status": "offers_in",
      "askingPrice": 85000,
      "interested": 3,
      "offers": 1,
      "bestOffer": 72000,
      "blastSends": 240
    }
  ],
  "totalDeals": 1,
  "dealsCapped": false,
  "blastWindowCapped": false,
  "buyers": [
    {
      "id": "contact_123",
      "name": "Jordan Smith",
      "buyBox": "{\"markets\":[\"Springfield\"],\"maxPrice\":90000}",
      "notes": "Cash buyer, can close in 14 days.",
      "tags": [
        "cash"
      ]
    }
  ],
  "totalBuyers": 1,
  "buyersCapped": false,
  "lists": [
    {
      "id": "list_123",
      "name": "Springfield cash buyers",
      "source": "manual",
      "dealId": "deal_123",
      "buyerIds": [
        "contact_123"
      ]
    }
  ],
  "listsCapped": false
}

Transactions

Transaction board

POST/api/agent-gateway/tc

Every open transaction file with its stage, closing date, overdue checklist items and what's due next.

Scopes: transactions:read
MCP tool: transaction_board

FieldTypeAbout
todaystringToday's date in the account's time zone (YYYY-MM-DD).
curl -X POST https://syntropic-crm.com/api/agent-gateway/tc \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"today":"2026-10-16"}'

Response 200: Every open transaction file with its closing date, task counts, next due item and overdue items.

{
  "today": "2026-10-16",
  "timezone": "America/Chicago",
  "files": [
    {
      "id": "tx_123",
      "address": "456 Oak Ave, Springfield, IL 62702",
      "status": "inspection",
      "closingDate": "2026-11-06",
      "openTasks": 6,
      "overdueTasks": 1,
      "nextDue": {
        "taskId": "task_201",
        "title": "Send inspection report to buyer's agent",
        "dueDate": "2026-10-14",
        "phase": "Inspections",
        "ownerName": "Morgan Diaz",
        "isCritical": true
      },
      "openItems": [
        {
          "taskId": "task_201",
          "title": "Send inspection report to buyer's agent",
          "dueDate": "2026-10-14",
          "phase": "Inspections",
          "ownerName": "Morgan Diaz",
          "isCritical": true,
          "requiredForStage": "inspection",
          "overdue": true
        }
      ]
    }
  ],
  "totalFiles": 1,
  "totalFilesComplete": true,
  "overdueChasesComplete": true
}

List chases

POST/api/agent-gateway/tc-chasesop list

Without a transactionId, every chase past its next-chase time. With one, that file's chase history.

Scopes: transactions:read
MCP tool: list_tc_chases

FieldTypeAbout
op (required)"list"
transactionIdstringA transaction file's id.
curl -X POST https://syntropic-crm.com/api/agent-gateway/tc-chases \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"list","transactionId":"<transactionId>"}'

Response 200: The overdue chase log, or one file's chases when you send transactionId.

{
  "scope": "overdue",
  "chases": [
    {
      "id": "chase_123",
      "transactionId": "tx_123",
      "address": "456 Oak Ave, Springfield, IL 62702",
      "itemLabel": "Send inspection report to buyer's agent",
      "partyRole": "agent",
      "partyName": "Casey Lee",
      "outcome": "no_answer",
      "hoursOverdue": 26
    }
  ],
  "truncated": false
}

Upload a document

POST/api/agent-gateway/tc-documentsChanges data

Attaches a document to a transaction file, on its Documents tab. Send the file bytes as the body with the file's Content-Type, and these fields as query parameters. Images, PDF or Word documents, up to 4 MB; upload bigger files in the app. Keys set to need approval can't upload: turn approval off for the key first. Not available over MCP.

Scopes: transactions:write

FieldTypeAbout
transactionId (required)stringThe transaction file's id. Up to 64 characters.
name (required)stringThe document's name, as shown on the Documents tab. At least 1 characters, up to 200 characters.
category"purchase_contract" | "addendum" | "assignment_contract" | "inspection_report" | "title_commitment" | "settlement_statement" | "scope_of_work" | "invoice" | "walkthrough" | "lender_doc" | "insurance" | "photo" | "other"The document's category.
curl -X POST "https://syntropic-crm.com/api/agent-gateway/tc-documents?transactionId=<transactionId>&name=Inspection.pdf&category=inspection_report" \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/pdf" \
  --data-binary @file.pdf

Response 200: a JSON object.

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

FieldTypeAbout
today (required)stringToday's date in the account's time zone (YYYY-MM-DD).
projectIdstringOnly 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

FieldTypeAbout
today (required)stringToday'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

FieldTypeAbout
op (required)"read"
projectIdstringOnly 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

FieldTypeAbout
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

FieldTypeAbout
op (required)"create"
text (required)stringWhat the reminder is for.
dueDate (required)stringDue date (YYYY-MM-DD).
dueTime (required)stringDue time, 24-hour HH:MM.
recordobject
record.kind (required in record)"lead" | "transaction" | "dispo_deal"
record.id (required in record)stringThe 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

FieldTypeAbout
op (required)"list"
leadId (required)stringThe 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

FieldTypeAbout
op (required)"create"
leadId (required)stringThe lead's id. Up to 64 characters.
title (required)stringWhat needs doing. Up to 300 characters.
dueDatestringDue date (YYYY-MM-DD).
dueTimestringDue time, 24-hour HH:MM. Needs a dueDate.
assigneeRepIdstringThe 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

FieldTypeAbout
op (required)"complete"
taskId (required)stringThe 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
}

Calendar

Calendar

POST/api/agent-gateway/calendar

The rep's agenda: today's and upcoming appointments.

Scopes: calendar:read
MCP tool: read_calendar

No fields. Send an empty body or {}.

curl -X POST https://syntropic-crm.com/api/agent-gateway/calendar \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response 200: The teammate's events today and tomorrow in the account's time zone.

{
  "today": {
    "date": "2026-10-16",
    "events": [
      {
        "id": "evt_123",
        "title": "Seller walkthrough: 412 Maple Ave",
        "startTime": "10:00",
        "endTime": "10:30",
        "allDay": false,
        "source": "gcal",
        "attendees": [
          {
            "name": "Jordan Smith",
            "kind": "contact"
          }
        ],
        "attendeeCount": 1,
        "linked": [
          {
            "kind": "lead",
            "label": "412 Maple Ave",
            "detail": null
          }
        ]
      }
    ]
  },
  "tomorrow": {
    "date": "2026-10-17",
    "events": []
  },
  "bounded": false,
  "linksTruncated": false
}

Meeting prep

POST/api/agent-gateway/meeting-prep

A brief for one of the rep's own appointments: the lead, recent notes, calls and texts, and open offers.

Scopes: calendar:read, leads:read, calls:read, texts:read, deals_offers:read
MCP tool: meeting_prep

FieldTypeAbout
eventId (required)stringThe calendar event's id.
curl -X POST https://syntropic-crm.com/api/agent-gateway/meeting-prep \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"eventId":"<eventId>"}'

Response 200: A brief for one of the teammate's events: the lead or contact, recent notes, calls and texts, and open offers.

{
  "timezone": "America/New_York",
  "event": {
    "id": "evt_123",
    "title": "Seller walkthrough: 412 Maple Ave",
    "date": "2026-10-16",
    "startTime": "10:00",
    "endTime": "10:30",
    "allDay": false,
    "source": "gcal",
    "attendees": [
      {
        "name": "Jordan Smith",
        "kind": "contact"
      }
    ],
    "attendeeCount": 1
  },
  "linkedBy": "calendar",
  "phoneAmbiguous": false,
  "restricted": false,
  "lead": {
    "label": "412 Maple Ave",
    "stage": "Offer sent",
    "archived": false,
    "nextFollowup": "2026-10-16 09:00",
    "nextTaskDue": null,
    "lastContacted": "2026-10-14 16:20"
  },
  "contact": {
    "name": "Jordan Smith",
    "category": "Seller"
  },
  "linked": [],
  "linksTruncated": false,
  "notes": {
    "items": [
      {
        "at": "2026-10-14 16:25",
        "body": "Seller wants to close in 30 days; spouse is on board."
      }
    ],
    "more": false
  },
  "calls": {
    "items": [
      {
        "at": "2026-10-14 16:05",
        "direction": "outbound",
        "outcome": "connected",
        "disposition": "Interested",
        "durationSeconds": 412,
        "summary": "Seller open to a cash offer in the low $160s if it closes in 30 days.",
        "summarySource": "ai"
      }
    ],
    "more": false
  },
  "texts": {
    "items": [
      {
        "at": "2026-10-15 18:05",
        "direction": "outbound",
        "body": "Hi Jordan, still good for 10 AM tomorrow at 412 Maple?",
        "status": "delivered"
      }
    ],
    "more": true
  },
  "offers": {
    "items": [
      {
        "at": "2026-10-14 17:40",
        "amount": 165000,
        "round": 1,
        "counterAmount": null,
        "status": "submitted"
      }
    ],
    "more": 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

FieldTypeAbout
limitintegerHow many calls to return. 1 to 50.
fromanyEpoch ms, or YYYY-MM-DD in the account's time zone.
untilanyEpoch ms, or YYYY-MM-DD in the account's time zone.
cursorstringThe 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

FieldTypeAbout
callId (required)stringThe 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

FieldTypeAbout
op (required)"call"
leadId (required)stringThe lead's id. Up to 64 characters.
to (required)stringA 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

FieldTypeAbout
leadId (required)stringThe lead's id. Up to 64 characters.
outcome (required)stringThe call outcome: one of the account's call dispositions, by key or label (for example no_answer, voicemail, connected). Up to 120 characters.
notesstringWhat was said. Up to 5,000 characters.
phonestringThe number called. It must be on the lead, unless the outcome is a Do Not Call disposition. Up to 40 characters.
occurredAtstringWhen 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

FieldTypeAbout
op (required)"text"
leadId (required)stringThe lead's id. Up to 64 characters.
to (required)stringA phone number on that lead. Up to 254 characters.
body (required)stringThe message. Up to 20,000 characters.
fromstringOptional. 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

FieldTypeAbout
leadIdstringThe lead's id. Send this or contactId. Up to 64 characters.
contactIdstringA contact's id. Send this or leadId. Up to 64 characters.
cursorstringThe cursor from the previous page, to read further back. Up to 4,000 characters.
limitintegerHow 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
}

Email

Send an email

POST/api/agent-gateway/commsop emailChanges data

Email an address on the lead as the rep. Do-not-email and unsubscribes always apply.

Scopes: email:send, leads:read
MCP tool: send_email

FieldTypeAbout
op (required)"email"
leadId (required)stringThe lead's id. Up to 64 characters.
to (required)stringAn email address on that lead. Up to 254 characters.
subject (required)stringThe subject line. Up to 300 characters.
body (required)stringThe message. Up to 20,000 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":"email","leadId":"<leadId>","to":"seller@example.com","subject":"Your property on Main St","body":"Hi Dana, thanks for your time today. Here is the offer we talked about."}'

Response 200: The email was sent and logged.

{
  "ok": true,
  "op": "email",
  "leadId": "lead_123",
  "to": "seller@example.com",
  "logged": true,
  "providerId": "sendgrid"
}

Read an email thread

POST/api/agent-gateway/email-thread

The emails between the rep's own mailbox and a lead or contact the rep can see, newest first, one page at a time. Other teammates' mail is never included, and an email that also belongs to a lead or contact the rep can't see is left out and counted in omitted. Addresses on records the rep can see are shown in full, as in the app. A page can hold fewer emails than the limit; keep reading while cursor is set.

Scopes: email:read, leads:read
MCP tool: read_email_thread

FieldTypeAbout
leadIdstringThe lead's id. Send this or contactId. Up to 64 characters.
contactIdstringA contact's id. Send this or leadId. Up to 64 characters.
cursorstringThe cursor from the previous page, to read further back. Up to 4,000 characters.
limitintegerHow many messages to return. 1 to 50.
curl -X POST https://syntropic-crm.com/api/agent-gateway/email-thread \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"leadId":"<leadId>","limit":20}'

Response 200: One page of emails between the rep's mailbox and the lead or contact, newest first. omitted counts emails left out; read on while cursor is set.

{
  "omitted": 0,
  "emails": [
    {
      "id": "email_321",
      "direction": "inbound",
      "subject": "Re: Your property on Main St",
      "snippet": "Thanks, we can do a walkthrough Saturday.",
      "at": 1792159500000,
      "from": "seller@example.com",
      "to": [
        "jordan@example.com"
      ],
      "leadId": "lead_123"
    }
  ],
  "cursor": null,
  "isDone": true
}

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).

FieldTypeAbout
leadId (required)stringThe lead's id.
purchasePricenumberPurchase price to test ($) At least 0.
repairCostnumberLump-sum repair estimate ($) At least 0.
repairQuantitiesobjectItemized repair scope: cheat-sheet item key to quantity.
repairQuantities.<key>numberAny key. At least 0.
holdMonthsnumberHold time in months. At least 0.
maoRulePctnumberMAO rule as % of ARV. 0 to 100.
wholesaleFeenumberWholesale fee ($) At least 0.
desiredProfitnumberDesired profit in dollars, used when the account's MAO formula includes it. Don't send with desiredProfitPct. 0 to 10000000.
desiredProfitPctnumberDesired 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).

FieldTypeAbout
arv (required)numberAfter-repair value ($) At least 0.
purchasePricenumberPurchase price ($) At least 0.
repairCostnumberLump-sum repair estimate ($) At least 0.
repairQuantitiesobjectItemized repair scope: cheat-sheet item key to quantity.
repairQuantities.<key>numberAny key. At least 0.
holdMonthsnumberHold time in months. At least 0.
sqftnumberLiving area in square feet. At least 0.
liensobject[]Financing on the deal, up to 5 liens.
liens[].labelstringA name for the lien. Up to 60 characters.
liens[].amountPct (required in liens)numberLoan amount as % of the cost basis. 0 to 100.
liens[].pointsnumberPoints and lender fees ($) At least 0.
liens[].ratePct (required in liens)numberAnnual interest rate (%). 0 to 50.
maoRulePctnumberMAO rule as % of ARV. 0 to 100.
wholesaleFeenumberWholesale fee ($) At least 0.
desiredProfitnumberDesired profit in dollars, used when the account's MAO formula includes it. Don't send with desiredProfitPct. 0 to 10000000.
desiredProfitPctnumberDesired 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).

FieldTypeAbout
arv (required)numberAfter-repair value ($) At least 0.
purchasePricenumberPurchase price ($) At least 0.
repairCostnumberLump-sum repair estimate ($) At least 0.
repairQuantitiesobjectItemized repair scope: cheat-sheet item key to quantity.
repairQuantities.<key>numberAny key. At least 0.
holdMonthsnumberHold time in months. At least 0.
sqftnumberLiving area in square feet. At least 0.
liensobject[]Financing on the deal, up to 5 liens.
liens[].labelstringA name for the lien. Up to 60 characters.
liens[].amountPct (required in liens)numberLoan amount as % of the cost basis. 0 to 100.
liens[].pointsnumberPoints and lender fees ($) At least 0.
liens[].ratePct (required in liens)numberAnnual 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).

FieldTypeAbout
repairQuantities (required)objectItemized repair scope: cheat-sheet item key to quantity.
repairQuantities.<key>numberAny 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).

FieldTypeAbout
price (required)numberPurchase price on terms ($) At least 0.
downPayment (required)numberDown payment to the seller ($) At least 0.
ratePctnumberSeller-note interest rate (annual %). At least 0.
termMonthsintegerSeller-note amortization in months. 1 to 480.
exit (required)"rent" | "resale"How the deal exits.
monthlyRentnumberRent exit: monthly rent ($) At least 0.
resalePricenumberResale exit: sale price ($) At least 0.
arvnumberARV 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).

FieldTypeAbout
op (required)"run"
leadIdstringThe lead's id. Give leadId or address, not both. Up to 120 characters.
addressstringOne-line property address, if there is no lead. Up to 200 characters.
rerunbooleanMake a new, charged run even if a fresh one exists.
idempotencyKeystringRetries with the same key and body return the same run. Up to 100 characters.
compCountintegerComps to value with. Default: the account setting. 4 to 12.
factsobjectSubject facts for this run; they win over the lead's.
facts.bedsintegerBedrooms. 0 to 20.
facts.bathsintegerFull baths. 0 to 20.
facts.halfBathsintegerHalf baths. 0 to 10.
facts.sqftintegerLiving area in square feet. 200 to 20000.
facts.yearBuiltintegerYear built. At least 1800.
facts.lotSqftintegerLot 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

FieldTypeAbout
op (required)"get"
runId (required)stringThe 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"
  }
}

Support tickets

Support tickets

POST/api/agent-gateway/support-tickets

Support tickets this account filed, newest first, with status and last update. Message text is not included.

Scopes: support:read
MCP tool: list_support_tickets

FieldTypeAbout
limitintegerHow many tickets to return. 1 to 50.
curl -X POST https://syntropic-crm.com/api/agent-gateway/support-tickets \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":20}'

Response 200: Newest first. truncated is true when more tickets exist than the limit. reason is "role", with an empty list, when the key's rep can't see team tickets.

{
  "tickets": [
    {
      "id": "ticket_123",
      "status": "open",
      "subject": "Can't import my leads",
      "requesterName": "Jordan Smith",
      "createdAt": 1792159200000,
      "updatedAt": 1792162800000,
      "lastAuthorRole": "staff"
    }
  ],
  "truncated": false,
  "limit": 20
}

Events

List recent events

POST/api/agent-gateway/eventsop list

CRM events from the last 30 days, newest first, limited to the leads and records the key's rep can open. Each call checks one page of up to 100 recorded events, so a page can be empty while nextCursor still has more. truncated is true when some events couldn't be checked and were left out.

Scopes: events:read
MCP tool: list_events

FieldTypeAbout
op (required)"list"
cursorstringThe nextCursor from the previous page. Up to 8,192 characters.
leadIdstringOnly this lead's events. Up to 64 characters.
kinds"lead_created" | "appointment_set" | "transaction_created" | "dispo_created" | "rental_closed" | "stage_entered" | "stage_left" | "lead_replied" | "call_outcome" | "no_activity" | "tag_added" | "field_changed" | "task_completed" | "deal_status" | "missed_call" | "followup_date_reached" | "duplicate_received" | "buyer_matched" | "record_created" | "record_status_entered" | "record_status_left" | "record_time_rule" | "record_field_changed" | "record_replied"[]Only these event kinds, at most 20.
curl -X POST https://syntropic-crm.com/api/agent-gateway/events \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"list","kinds":["stage_entered","call_outcome"]}'

Response 200: Newest first, from the last 30 days by recorded time, and only events on leads and records the key's rep can open. A page can have no events while nextCursor still has more; nextCursor is null when nothing is left. truncated is true when some events couldn't be checked in this call and were left out. details holds only ids and enums, never field values.

{
  "events": [
    {
      "id": "event_123",
      "kind": "stage_entered",
      "occurredAt": 1792159200000,
      "recordedAt": 1792159201000,
      "lead": {
        "id": "lead_123"
      },
      "record": null,
      "details": {
        "stage_key": "offer_made",
        "from_stage_key": "new"
      }
    }
  ],
  "nextCursor": "1789567200000:cursor_abc",
  "truncated": false,
  "window": {
    "days": 30
  }
}

Dialer

Dialer session status

POST/api/agent-gateway/dialer-sessions

The account's live power dialer sessions: rep, state, start time, lines and counts. No phone numbers or lead names.

Scopes: dialer:read
MCP tool: dialer_session_status

FieldTypeAbout
limitintegerHow many sessions to return. 1 to 50.
curl -X POST https://syntropic-crm.com/api/agent-gateway/dialer-sessions \
  -H "Authorization: Bearer $SYNTROPIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":20}'

Response 200: Live sessions, newest start first. A key whose rep sees the whole book gets every rep's sessions; any other key gets its own rep's. truncated is true when more sessions exist than the limit or the read was cut. liveLinesTruncated is true when a session's live lines reached the 20-line count cap. listName reads "Private list" when the list is another rep's personal list, or has been archived or deleted. No phone numbers or lead names.

{
  "sessions": [
    {
      "sessionId": "session_123",
      "rep": "Jordan Smith",
      "status": "active",
      "mode": "sequential",
      "dialer": "power",
      "listName": "Absentee owners",
      "startedAt": 1792159200000,
      "updatedAt": 1792162800000,
      "lines": 3,
      "linesAllowed": 3,
      "liveLines": 2,
      "liveLinesTruncated": false,
      "dials": 48,
      "connects": 6,
      "appts": 1,
      "agentInRoom": true
    }
  ],
  "truncated": false,
  "limit": 20,
  "dialerVoiceEnabled": true
}
REST reference | Syntropic Developers