Add Competitor Team Member

POST

competitors

{id}

tracked-persons

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor" }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ linkedin_url: "https://www.linkedin.com/in/jane-doe", relationship: "investor" }),
});

{
  "success": true,
  "data": {
    "tracked_person": {
      "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
      "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
      "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
      "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
      "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "person_linkedin_id": "jane-doe",
      "full_name": "Jane Doe",
      "title": "VP Sales",
      "role_bucket": "exec",
      "priority": 1,
      "source": "manual",
      "status": "monitored",
      "function": "sales",
      "monitored_since": "2026-10-05T09:00:00Z",
      "still_employed": true,
      "created_at": "2026-10-05T09:00:00Z",
      "updated_at": "2026-10-05T09:00:00Z"
    },
    "slot_usage": { "used": 183, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 183, "limit": 200 }
  }
}

{
  "success": false,
  "error": { "message": "No slot left: 1 needed, 0 free. Pause someone else, or contact Clustr to raise the limit.", "code": "NO_SLOT" }
}

{
  "success": false,
  "error": { "message": "We couldn't find that LinkedIn profile", "code": "PROFILE_NOT_RESOLVED" }
}

Add one person to a competitor’s Team and monitor them, either by their LinkedIn profile URL or by picking them from the competitor’s employees (List Competitor Employees). Clustr looks the profile up on LinkedIn, and the person stays on the Team whatever the team search finds. Their activity is collected from the next scan. A monitored person takes one slot. When every slot is in use the answer is 409 NO_SLOT: pause someone else, or contact Clustr to raise your limit. Adding someone already on the Team returns their row, monitored. Adding someone you removed puts them back. Send linkedin_url or employee_id. To follow someone by name, find their profile first with Search LinkedIn People. Send relationship to say how they are tied to the competitor: employee, investor, partner, advisor or other. A linkedin_url with none is an employee. The monthly team check never marks someone added by hand as having left or changed role, since an investor or a partner may never have worked there.

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor" }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ linkedin_url: "https://www.linkedin.com/in/jane-doe", relationship: "investor" }),
});

{
  "success": true,
  "data": {
    "tracked_person": {
      "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
      "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
      "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
      "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
      "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "person_linkedin_id": "jane-doe",
      "full_name": "Jane Doe",
      "title": "VP Sales",
      "role_bucket": "exec",
      "priority": 1,
      "source": "manual",
      "status": "monitored",
      "function": "sales",
      "monitored_since": "2026-10-05T09:00:00Z",
      "still_employed": true,
      "created_at": "2026-10-05T09:00:00Z",
      "updated_at": "2026-10-05T09:00:00Z"
    },
    "slot_usage": { "used": 183, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 183, "limit": 200 }
  }
}

{
  "success": false,
  "error": { "message": "No slot left: 1 needed, 0 free. Pause someone else, or contact Clustr to raise the limit.", "code": "NO_SLOT" }
}

{
  "success": false,
  "error": { "message": "We couldn't find that LinkedIn profile", "code": "PROFILE_NOT_RESOLVED" }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

The competitor's Clustr ID (cmp_…), from List Competitors. The id from earlier responses also works.

Body

application/json

Send linkedin_url or employee_id.

linkedin_url

string

The person's LinkedIn profile URL (https://www.linkedin.com/in/...). A URL that resolves to no profile returns 422 PROFILE_NOT_RESOLVED. The person's source is manual.

Example:

"https://www.linkedin.com/in/jane-doe"

employee_id

string

A person_linkedin_id from List Competitor Employees. The person's source is employee_list, shown as a manual addition.

relationship

enum<string>

How they are tied to the competitor. A linkedin_url with none is an employee. Someone with a relationship is never marked as left or as changed role by the monthly team check: they may not work there.

Available options:

employee,

investor,

partner,

advisor,

other

Example:

"investor"

Response

The person, as now tracked

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl -X POST https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor" }'

import requests

requests.post(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"linkedin_url": "https://www.linkedin.com/in/jane-doe", "relationship": "investor"},
)

await fetch("https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ linkedin_url: "https://www.linkedin.com/in/jane-doe", relationship: "investor" }),
});

{
  "success": true,
  "data": {
    "tracked_person": {
      "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
      "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
      "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
      "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
      "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "person_linkedin_id": "jane-doe",
      "full_name": "Jane Doe",
      "title": "VP Sales",
      "role_bucket": "exec",
      "priority": 1,
      "source": "manual",
      "status": "monitored",
      "function": "sales",
      "monitored_since": "2026-10-05T09:00:00Z",
      "still_employed": true,
      "created_at": "2026-10-05T09:00:00Z",
      "updated_at": "2026-10-05T09:00:00Z"
    },
    "slot_usage": { "used": 183, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 183, "limit": 200 }
  }
}

{
  "success": false,
  "error": { "message": "No slot left: 1 needed, 0 free. Pause someone else, or contact Clustr to raise the limit.", "code": "NO_SLOT" }
}

{
  "success": false,
  "error": { "message": "We couldn't find that LinkedIn profile", "code": "PROFILE_NOT_RESOLVED" }
}

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

Add Competitor Team Member

Authorizations

Path Parameters

Body

Response