> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytikt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracked profile events

> The LinkedIn profiles you track: added, ready, changed, paused, archived, and their daily follower count.

Every event arrives in the same [envelope](/webhooks#the-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](/webhooks/objects#tracked-profile)). Its figures are still empty: they fill in when the profile is first read.

<Accordion title="Example: kol.added">
  ```json theme={null}
  {
    "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"
      }
    }
  }
  ```
</Accordion>

## kol.ready

The first read of a tracked profile is done.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)) and `posts_listed`: the number of its posts TIKT found.

<Accordion title="Example: kol.ready">
  ```json theme={null}
  {
    "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
    }
  }
  ```
</Accordion>

## kol.updated

A tracked profile's relationship or label changes.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)) and `changes`: `{relationship?, custom_label?}`, each `{from, to}`.

<Accordion title="Example: kol.updated">
  ```json theme={null}
  {
    "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"
        }
      }
    }
  }
  ```
</Accordion>

## kol.paused

Scanning a tracked profile is paused; the profile stays tracked.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)) and `paused_at`.

<Accordion title="Example: kol.paused">
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</Accordion>

## kol.resumed

Scanning a tracked profile resumes.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)). `auto_harvest.since` says from when its posts are harvested again.

<Accordion title="Example: kol.resumed">
  ```json theme={null}
  {
    "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"
      }
    }
  }
  ```
</Accordion>

## kol.archived

A profile is removed from tracking.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)) and `archived_at`.

<Accordion title="Example: kol.archived">
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</Accordion>

## kol.restored

A removed profile is tracked again.

**Data:** `kol` ([tracked profile](/webhooks/objects#tracked-profile)) and `restored_at`.

<Accordion title="Example: kol.restored">
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</Accordion>

## 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`.

<Accordion title="Example: kol.followers_recorded">
  ```json theme={null}
  {
    "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"
    }
  }
  ```
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.