Manage SDR Threads via API - Leadterra

SDR prospect threads represent conversations forwarded from campaign replies. Use these endpoints to build agent-driven SDR workflows.

List inbox threads

curl "https://app.leadterra.co/v1/sdr/inbox?status=new&limit=20" \
  -H "Authorization: Bearer sk_live_your_key"

Filter by status, category, search term, or snooze state. Sort by priority, lastMessage, or created.

{
  "data": {
    "threads": [
      {
        "id": "thread_id",
        "contactEmail": "ava@example.com",
        "contactName": "Ava Patel",
        "subject": "Re: Quick question",
        "status": "new",
        "category": "A",
        "priorityScore": 85,
        "lastMessageAt": "2026-06-28T18:30:00.000Z"
      }
    ],
    "total": 1,
    "hasMore": false
  }
}

Get thread details

curl https://app.leadterra.co/v1/sdr/inbox/THREAD_ID \
  -H "Authorization: Bearer sk_live_your_key"

Returns the thread with participants, linked threads, and MQL handoff context.

Update thread status

curl -X PUT https://app.leadterra.co/v1/sdr/inbox/THREAD_ID/status \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "awaiting_reply"}'

View conversation history

curl https://app.leadterra.co/v1/sdr/threads/THREAD_ID/messages \
  -H "Authorization: Bearer sk_live_your_key"

Returns the full Gmail conversation thread, including original sent emails and prospect replies.