Leads

GET /leads

List sales leads in the org.

Query parameters

Request example

curl -sS "https://api.strackerapp.com/v1/leads?limit=5" \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": {
    "leads": [
      {
        "id": 1,
        "company_name": "Acme",
        "email": "[email protected]",
        "deal_stage_id": 2,
        "assigned_to": "[email protected]",
        "assignee": { "email": "[email protected]", "name": "Alex Rep" }
      }
    ],
    "pagination": { "limit": 5, "offset": 0 }
  }
}

POST /leads

Create a sales lead. Provide company_name and/or first_name/last_name. Optional note_id for UI-style auto-save of the actor’s own Text followup.

Body parameters

Request example

curl -sS https://api.strackerapp.com/v1/leads \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"company_name":"Acme","email":"[email protected]","deal_stage_id":1}'

Response 201 Created

{
  "success": true,
  "data": {
    "lead": { "id": 2, "company_name": "Acme", "email": "[email protected]", "deal_stage_id": 1 }
  }
}

GET /leads/{id}

Fetch a single sales lead including assignee join.

Path parameters

Request example

curl -sS https://api.strackerapp.com/v1/leads/1 \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": {
    "lead": {
      "id": 1,
      "company_name": "Acme",
      "assigned_to": "[email protected]",
      "assignee": { "email": "[email protected]", "name": "Alex Rep" },
      "deal_stage_id": 2
    }
  }
}

PATCH PUT /leads/{id}

Update lead fields. deal_stage_id syncs denormalized status to the stage name (same as UI). assigned_to must be an active org member email (or null to unassign).

Path parameters

Body parameters

Request example

curl -sS -X PATCH https://api.strackerapp.com/v1/leads/1 \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"deal_stage_id":2,"assigned_to":"[email protected]"}'

Response 200 OK

{
  "success": true,
  "data": {
    "lead": { "id": 1, "deal_stage_id": 2, "assigned_to": "[email protected]" }
  }
}

GET /leads/statuses

List deal stages available for leads.

Request example

curl -sS https://api.strackerapp.com/v1/leads/statuses \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": {
    "statuses": [
      { "id": 1, "name": "New" },
      { "id": 2, "name": "Qualified" }
    ]
  }
}

POST PATCH /leads/{id}/stage

Move a lead to a deal stage. Body: {"deal_stage_id": N}. Equivalent to PATCH lead with deal_stage_id.

Path parameters

Body parameters

Request example

curl -sS -X POST https://api.strackerapp.com/v1/leads/1/stage \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"deal_stage_id":1}'

Response 200 OK

{
  "success": true,
  "data": {
    "lead": { "id": 1, "deal_stage_id": 1, "status": "New" }
  }
}

POST PATCH /leads/{id}/assignee

Assign a lead to an org member. Accepts assigned_to (email), user_id, or org_user_id. Pass assigned_to: null to unassign. Rejects emails that are not active org_users.

Path parameters

Body parameters

Request example

curl -sS -X POST https://api.strackerapp.com/v1/leads/1/assignee \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"assigned_to":"[email protected]"}'

Response 200 OK

{
  "success": true,
  "data": {
    "lead": { "id": 1, "assigned_to": "[email protected]", "assignee": { "email": "[email protected]", "name": "Alex Rep" } }
  }
}

GET /leads/{id}/activities

Activity timeline (followups). Filter: all|pending|completed|upcoming|past.

Path parameters

Query parameters

Request example

curl -sS "https://api.strackerapp.com/v1/leads/1/activities?limit=10" \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": {
    "activities": [
      { "id": 55, "followup_type": "Text", "notes": "pinged", "completed": 0 }
    ]
  }
}

POST /leads/{id}/activities

Create Call/Text/Meeting/Email/…. Optional deal_stage_id moves the stage.

Path parameters

Body parameters

Request example

curl -sS https://api.strackerapp.com/v1/leads/1/activities \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"followup_type":"Text","notes":"smoke activity note"}'

Response 201 Created

{
  "success": true,
  "data": {
    "activity": { "id": 56, "followup_type": "Text", "notes": "smoke activity note" }
  }
}

GET /leads/{id}/activities/{activityId}

Fetch a single activity.

Path parameters

Request example

curl -sS https://api.strackerapp.com/v1/leads/1/activities/55 \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": {
    "activity": { "id": 55, "followup_type": "Call", "call_outcome": "connected", "notes": "spoke 5m" }
  }
}

PATCH PUT /leads/{id}/activities/{activityId}

Update notes/date/outcome, or set action=complete|uncomplete|reschedule|delete. Reschedule bumps event_sequence and does not send ICS.

Path parameters

Body parameters

Request example

curl -sS -X PATCH https://api.strackerapp.com/v1/leads/1/activities/55 \
  -H "Authorization: Bearer sk_REPLACE" \
  -H "Content-Type: application/json" \
  -d '{"action":"reschedule","followup_date":"2026-09-25 15:00:00"}'

Response 200 OK

{
  "success": true,
  "data": {
    "activity": { "id": 55, "followup_date": "2026-09-25 15:00:00", "event_sequence": 2 }
  }
}

DELETE /leads/{id}/activities/{activityId}

Same as action=delete. Does not send a calendar cancel email.

Path parameters

Request example

curl -sS -X DELETE https://api.strackerapp.com/v1/leads/1/activities/55 \
  -H "Authorization: Bearer sk_REPLACE"

Response 200 OK

{
  "success": true,
  "data": { "deleted": true }
}