Tracked profile events

Every event arrives in the same envelope: only data changes. The examples are fictional, and indented here for reading; the request body is compact JSON.

kol.added

A LinkedIn profile is tracked: added in the console, during onboarding, or with Track. Data: kol (tracked profile). Its figures are still empty: they fill in when the profile is first read.

Example: kol.added

{
  "id": "94b70280-6d91-4c0c-8048-712e99b02940",
  "type": "kol.added",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/",
      "public_identifier": "drew-harper-example",
      "name": "Drew Harper",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "active",
      "auto_harvest": {
        "enabled": true,
        "since": null
      },
      "onboarding_state": "pending",
      "followers_count": null,
      "posts_last_28_days": null,
      "posts_per_week": null,
      "typical_engagement": null,
      "engagement_p90": null,
      "followers_gained_7d": null,
      "followers_gained_30d": null,
      "last_post_at": null,
      "added_at": "2026-10-06T08:10:07Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=f6e53743-d2d1-499a-8735-487188ed4edd"
    }
  }
}

kol.ready

The first read of a tracked profile is done. Data: kol (tracked profile) and posts_listed: the number of its posts TIKT found.

Example: kol.ready

{
  "id": "bbcd9cc9-e262-40ea-89ba-2347f698fe8d",
  "type": "kol.ready",
  "created_at": "2026-10-06T20:02:28Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/",
      "public_identifier": "drew-harper-example",
      "name": "Drew Harper",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "active",
      "auto_harvest": {
        "enabled": true,
        "since": null
      },
      "onboarding_state": "completed",
      "followers_count": 44120,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=f6e53743-d2d1-499a-8735-487188ed4edd"
    },
    "posts_listed": 27
  }
}

kol.updated

A tracked profile’s relationship or label changes. Data: kol (tracked profile) and changes: {relationship?, custom_label?}, each {from, to}.

Example: kol.updated

{
  "id": "3142f925-3372-41fb-81e9-2d1b68058300",
  "type": "kol.updated",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/",
      "public_identifier": "drew-harper-example",
      "name": "Drew Harper",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example",
      "relationship": "influencer",
      "custom_label": null,
      "state": "active",
      "auto_harvest": {
        "enabled": true,
        "since": null
      },
      "onboarding_state": "completed",
      "followers_count": 44120,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=f6e53743-d2d1-499a-8735-487188ed4edd"
    },
    "changes": {
      "relationship": {
        "from": "competitor",
        "to": "influencer"
      }
    }
  }
}

kol.paused

Scanning a tracked profile is paused; the profile stays tracked. Data: kol (tracked profile) and paused_at.

Example: kol.paused

{
  "id": "68f133de-95dc-4add-87d5-9f373d679cf8",
  "type": "kol.paused",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/",
      "public_identifier": "drew-harper-example",
      "name": "Drew Harper",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "paused",
      "auto_harvest": {
        "enabled": false,
        "since": null
      },
      "onboarding_state": "completed",
      "followers_count": 44120,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=f6e53743-d2d1-499a-8735-487188ed4edd"
    },
    "paused_at": "2026-10-06T19:00:00Z"
  }
}

kol.resumed

Scanning a tracked profile resumes. Data: kol (tracked profile). auto_harvest.since says from when its posts are harvested again.

Example: kol.resumed

{
  "id": "171385b2-cc70-4f4a-8994-761061af90c6",
  "type": "kol.resumed",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/",
      "public_identifier": "drew-harper-example",
      "name": "Drew Harper",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "active",
      "auto_harvest": {
        "enabled": true,
        "since": "2026-10-07T09:00:00Z"
      },
      "onboarding_state": "completed",
      "followers_count": 44120,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=f6e53743-d2d1-499a-8735-487188ed4edd"
    }
  }
}

kol.archived

A profile is removed from tracking. Data: kol (tracked profile) and archived_at.

Example: kol.archived

{
  "id": "6b6aaae0-4b05-4053-8e06-a99d2fea884b",
  "type": "kol.archived",
  "created_at": "2026-10-04T20:01:05Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "b2905fad-ec45-4372-8785-cb41295dafb6",
      "linkedin_url": "https://www.linkedin.com/in/avery-collins-example/",
      "public_identifier": "avery-collins-example",
      "name": "Avery Collins",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/avery-collins-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "archived",
      "auto_harvest": {
        "enabled": false,
        "since": null
      },
      "onboarding_state": "completed",
      "followers_count": 18230,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=b2905fad-ec45-4372-8785-cb41295dafb6"
    },
    "archived_at": "2026-10-04T20:01:05Z"
  }
}

kol.restored

A removed profile is tracked again. Data: kol (tracked profile) and restored_at.

Example: kol.restored

{
  "id": "950f5658-52ee-4f4c-874f-2dbae91d2ef2",
  "type": "kol.restored",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "b2905fad-ec45-4372-8785-cb41295dafb6",
      "linkedin_url": "https://www.linkedin.com/in/avery-collins-example/",
      "public_identifier": "avery-collins-example",
      "name": "Avery Collins",
      "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/avery-collins-example",
      "relationship": "competitor",
      "custom_label": null,
      "state": "active",
      "auto_harvest": {
        "enabled": true,
        "since": null
      },
      "onboarding_state": "completed",
      "followers_count": 18230,
      "posts_last_28_days": 12,
      "posts_per_week": 3,
      "typical_engagement": 61.5,
      "engagement_p90": 174,
      "followers_gained_7d": 96,
      "followers_gained_30d": 410,
      "last_post_at": "2026-10-06T07:01:57Z",
      "added_at": "2026-09-12T09:30:00Z",
      "console_url": "https://app.trytikt.com/watchlist?kol=b2905fad-ec45-4372-8785-cb41295dafb6"
    },
    "restored_at": "2026-10-06T08:10:07Z"
  }
}

kol.followers_recorded

A tracked profile’s follower count is recorded: once per profile and per day, paused profiles included. Data: kol ({id, name, relationship, linkedin_url}), day, followers_count and observed_at.

Example: kol.followers_recorded

{
  "id": "9163d614-3610-49ca-8c19-ea32cc9991e3",
  "type": "kol.followers_recorded",
  "created_at": "2026-10-06T20:02:27Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "kol": {
      "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
      "name": "Drew Harper",
      "relationship": "competitor",
      "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/"
    },
    "day": "2026-10-06",
    "followers_count": 44120,
    "observed_at": "2026-10-06T20:02:27Z"
  }
}

Get started

Webhooks

Events

Tracked profile events

kol.added

kol.ready

kol.updated

kol.paused

kol.resumed

kol.archived

kol.restored

kol.followers_recorded

​kol.added

​kol.ready

​kol.updated

​kol.paused

​kol.resumed

​kol.archived

​kol.restored

​kol.followers_recorded

kol.added

kol.ready

kol.updated

kol.paused

kol.resumed

kol.archived

kol.restored

kol.followers_recorded