List Warm Intro Activity

GET

paths

activity

curl "https://api.clustr-ai.com/api/public/paths/activity?client_linkedin_id=per_68gef5wxsnd7wfsfz798svc4q3&prospect_linkedin_id=per_wqt0td77p59gcnshs759ewyyj1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "events": [
      {
        "clustrRecordActivityId": "act_pmrexzr1a65a55kt261wwhmzqr",
        "id": "5b1c0d2e-8f3a-4c1e-9d7b-2a6f4e8c1b90",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "tags_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "names": ["Contacted"],
          "from": { "names": ["Assigned"] },
          "actorName": "Alice Martin",
          "actorEmail": "alice@yourco.com"
        },
        "occurredAt": "2026-09-24T09:12:00Z",
        "count": 1,
        "firstAt": "2026-09-24T09:12:00Z"
      },
      {
        "clustrRecordActivityId": "act_arw59my4ffvv7znx06ebt6epqn",
        "id": "a2d9e4f1-6b3c-4e7a-8f1d-0c5b9a7e2d46",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "owner_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "email": "alice@yourco.com",
          "from": { "ownerId": "", "email": "" },
          "actorName": "Alice Martin"
        },
        "occurredAt": "2026-09-23T16:40:00Z",
        "count": 1,
        "firstAt": "2026-09-23T16:40:00Z"
      }
    ],
    "has_more": false
  }
}

{
  "success": false,
  "error": { "message": "warm intro not found", "code": "NOT_FOUND" }
}

Everything that happened to one warm intro, newest first: who made themselves or someone else the owner, who changed the status, note edits, dismissals and intro requests. See Record Activity for every kind. Name the intro by its two people, with their Clustr IDs or LinkedIn ids, or by the opportunity’s Clustr ID.

Response

Each event names its kind, its actor (a member’s id or email, crm:<provider>, a Workflow, or system) and a detail that says what changed and what it was before. When the actor is a member, detail also carries actorName and actorEmail. Entries Clustr filled in from dates it already had, for changes made before this history was recorded, carry "backfilled": true.

curl "https://api.clustr-ai.com/api/public/paths/activity?client_linkedin_id=per_68gef5wxsnd7wfsfz798svc4q3&prospect_linkedin_id=per_wqt0td77p59gcnshs759ewyyj1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "events": [
      {
        "clustrRecordActivityId": "act_pmrexzr1a65a55kt261wwhmzqr",
        "id": "5b1c0d2e-8f3a-4c1e-9d7b-2a6f4e8c1b90",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "tags_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "names": ["Contacted"],
          "from": { "names": ["Assigned"] },
          "actorName": "Alice Martin",
          "actorEmail": "alice@yourco.com"
        },
        "occurredAt": "2026-09-24T09:12:00Z",
        "count": 1,
        "firstAt": "2026-09-24T09:12:00Z"
      },
      {
        "clustrRecordActivityId": "act_arw59my4ffvv7znx06ebt6epqn",
        "id": "a2d9e4f1-6b3c-4e7a-8f1d-0c5b9a7e2d46",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "owner_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "email": "alice@yourco.com",
          "from": { "ownerId": "", "email": "" },
          "actorName": "Alice Martin"
        },
        "occurredAt": "2026-09-23T16:40:00Z",
        "count": 1,
        "firstAt": "2026-09-23T16:40:00Z"
      }
    ],
    "has_more": false
  }
}

{
  "success": false,
  "error": { "message": "warm intro not found", "code": "NOT_FOUND" }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Query Parameters

client_linkedin_id

string

The connector side of the warm intro, by Clustr ID (per_…) or LinkedIn id. Send it with prospect_linkedin_id.

prospect_linkedin_id

string

The prospect side of the warm intro, by Clustr ID (per_…) or LinkedIn id.

opportunity_id

string

The warm intro's Clustr ID (opp_…), instead of the two people. The opportunity id from earlier responses also works.

limit

integer

default:50

The number of events per page, up to 200.

Required range: x <= 200

offset

integer

default:0

The number of events to skip, for the next page when has_more is true.

Response

The warm intro's history

success

boolean

data

object

Show child attributes

curl "https://api.clustr-ai.com/api/public/paths/activity?client_linkedin_id=per_68gef5wxsnd7wfsfz798svc4q3&prospect_linkedin_id=per_wqt0td77p59gcnshs759ewyyj1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "events": [
      {
        "clustrRecordActivityId": "act_pmrexzr1a65a55kt261wwhmzqr",
        "id": "5b1c0d2e-8f3a-4c1e-9d7b-2a6f4e8c1b90",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "tags_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "names": ["Contacted"],
          "from": { "names": ["Assigned"] },
          "actorName": "Alice Martin",
          "actorEmail": "alice@yourco.com"
        },
        "occurredAt": "2026-09-24T09:12:00Z",
        "count": 1,
        "firstAt": "2026-09-24T09:12:00Z"
      },
      {
        "clustrRecordActivityId": "act_arw59my4ffvv7znx06ebt6epqn",
        "id": "a2d9e4f1-6b3c-4e7a-8f1d-0c5b9a7e2d46",
        "entity": "path",
        "recordKey": "janedoe|johnsmith",
        "kind": "owner_set",
        "actor": "3f6e2a91-7c4b-4d8e-a1f2-9b0c5d7e6f13",
        "detail": {
          "email": "alice@yourco.com",
          "from": { "ownerId": "", "email": "" },
          "actorName": "Alice Martin"
        },
        "occurredAt": "2026-09-23T16:40:00Z",
        "count": 1,
        "firstAt": "2026-09-23T16:40:00Z"
      }
    ],
    "has_more": false
  }
}

{
  "success": false,
  "error": { "message": "warm intro not found", "code": "NOT_FOUND" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

List Warm Intro Activity

Response

Authorizations

Query Parameters

Response

​Response

Authorizations

Query Parameters

Response

Response