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

# Post events

> Posts TIKT finds on your tracked profiles, harvests, pauses and closes.

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.

## post.discovered

TIKT finds a new post: during a cycle, when you add a post by hand, or when a newly tracked profile is first read.

**Data:** `post` ([post](/webhooks/objects#post)), with its three blocks `harvest`, `performance_vs_usual` and `yield`.

<Note>
  A post TIKT already knows is not sent again when its counters change.
</Note>

<Accordion title="Example: post.discovered">
  ```json theme={null}
  {
    "id": "4dadc8ec-65d3-45ef-87eb-f16c44a016e9",
    "type": "post.discovered",
    "created_at": "2026-10-06T08:02:53Z",
    "api_version": "2026-10-01",
    "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
    "data": {
      "post": {
        "id": "011c46fa-46b7-45d8-8911-df2f20ea4080",
        "linkedin_post_id": "7450227443607533490",
        "urn": "urn:li:activity:7450227443607533490",
        "url": "https://www.linkedin.com/posts/drew-harper-example_three-mistakes-finance-teams-activity-7450227443607533490-Ab1c",
        "author": {
          "type": "profile",
          "name": "Drew Harper",
          "public_id": "drew-harper-example",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example",
          "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example"
        },
        "text": "We reviewed 120 finance teams this year. The same three mistakes keep coming back. ➡️ Forecasts built once a quarter, then forgotten. ➡️ Tools bought without an owner. ➡️ Reports nobody reads. Here is the checklist we now use with every new team, step by step, with the questions we ask in the first week and the numbers we look at before anything else.",
        "hashtags": [],
        "media_type": "image",
        "media": {
          "images": [
            "https://media.licdn.com/dms/image/v2/EXAMPLE/feedshare-shrink_1280/0/three-mistakes-finance-teams-1-example"
          ],
          "videos": []
        },
        "external_links": [
          "https://www.example.com/three-mistakes-finance-teams"
        ],
        "is_repost": false,
        "posted_at": "2026-10-06T07:01:57Z",
        "counters": {
          "reactions": 214,
          "comments": 187,
          "checked_at": "2026-10-06T20:02:27Z"
        },
        "tracking_status": "hot",
        "source": "auto",
        "kol": {
          "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
          "name": "Drew Harper",
          "relationship": "competitor",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/"
        },
        "console_url": "https://app.trytikt.com/posts?post=011c46fa-46b7-45d8-8911-df2f20ea4080",
        "harvest": {
          "state": "harvesting",
          "paused": false,
          "excluded_reason": null
        },
        "performance_vs_usual": 2.07,
        "yield": {
          "people_captured": 14,
          "leads_at_threshold": 0,
          "avg_score_at_threshold": null
        }
      }
    }
  }
  ```
</Accordion>

## post.harvested

A harvest of a post finishes: the people who reacted or commented were read, scored and charged.

**Data:** `post` ([post](/webhooks/objects#post)) and `harvest`: `{harvested_at, people_processed, credits_charged, leads_created, leads_updated, leads_discarded_by_score}`.

<Accordion title="Example: post.harvested">
  ```json theme={null}
  {
    "id": "5e494bfa-56a3-4718-8aa1-6f8778108d85",
    "type": "post.harvested",
    "created_at": "2026-10-06T16:05:23Z",
    "api_version": "2026-10-01",
    "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
    "data": {
      "post": {
        "id": "011c46fa-46b7-45d8-8911-df2f20ea4080",
        "linkedin_post_id": "7450227443607533490",
        "urn": "urn:li:activity:7450227443607533490",
        "url": "https://www.linkedin.com/posts/drew-harper-example_three-mistakes-finance-teams-activity-7450227443607533490-Ab1c",
        "author": {
          "type": "profile",
          "name": "Drew Harper",
          "public_id": "drew-harper-example",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example",
          "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example"
        },
        "text": "We reviewed 120 finance teams this year. The same three mistakes keep coming back. ➡️ Forecasts built once a quarter, then forgotten. ➡️ Tools bought without an owner. ➡️ Reports nobody reads. Here is the checklist we now use with every new team, step by step, with the questions we ask in the first week and the numbers we look at before anything else.",
        "hashtags": [],
        "media_type": "image",
        "media": {
          "images": [
            "https://media.licdn.com/dms/image/v2/EXAMPLE/feedshare-shrink_1280/0/three-mistakes-finance-teams-1-example"
          ],
          "videos": []
        },
        "external_links": [
          "https://www.example.com/three-mistakes-finance-teams"
        ],
        "is_repost": false,
        "posted_at": "2026-10-06T07:01:57Z",
        "counters": {
          "reactions": 214,
          "comments": 187,
          "checked_at": "2026-10-06T20:02:27Z"
        },
        "tracking_status": "hot",
        "source": "auto",
        "kol": {
          "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
          "name": "Drew Harper",
          "relationship": "competitor",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/"
        },
        "console_url": "https://app.trytikt.com/posts?post=011c46fa-46b7-45d8-8911-df2f20ea4080",
        "harvest": {
          "state": "harvesting",
          "paused": false,
          "excluded_reason": null
        },
        "performance_vs_usual": 2.07,
        "yield": {
          "people_captured": 14,
          "leads_at_threshold": 0,
          "avg_score_at_threshold": null
        }
      },
      "harvest": {
        "harvested_at": "2026-10-06T16:05:23Z",
        "people_processed": 45,
        "credits_charged": 16,
        "leads_created": 4,
        "leads_updated": 0,
        "leads_discarded_by_score": 8
      }
    }
  }
  ```
</Accordion>

## post.harvest\_paused

Harvesting a post is paused.

**Data:** `post` ([post](/webhooks/objects#post)), `paused_at` and `paused_by` (`console` or `tikt`).

<Accordion title="Example: post.harvest_paused">
  ```json theme={null}
  {
    "id": "7b930755-9607-45d3-8866-54b6a1724597",
    "type": "post.harvest_paused",
    "created_at": "2026-10-06T08:10:07Z",
    "api_version": "2026-10-01",
    "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
    "data": {
      "post": {
        "id": "011c46fa-46b7-45d8-8911-df2f20ea4080",
        "linkedin_post_id": "7450227443607533490",
        "urn": "urn:li:activity:7450227443607533490",
        "url": "https://www.linkedin.com/posts/drew-harper-example_three-mistakes-finance-teams-activity-7450227443607533490-Ab1c",
        "author": {
          "type": "profile",
          "name": "Drew Harper",
          "public_id": "drew-harper-example",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example",
          "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example"
        },
        "text": "We reviewed 120 finance teams this year. The same three mistakes keep coming back. ➡️ Forecasts built once a quarter, then forgotten. ➡️ Tools bought without an owner. ➡️ Reports nobody reads. Here is the checklist we now use with every new team, step by step, with the questions we ask in the first week and the numbers we look at before anything else.",
        "hashtags": [],
        "media_type": "image",
        "media": {
          "images": [
            "https://media.licdn.com/dms/image/v2/EXAMPLE/feedshare-shrink_1280/0/three-mistakes-finance-teams-1-example"
          ],
          "videos": []
        },
        "external_links": [
          "https://www.example.com/three-mistakes-finance-teams"
        ],
        "is_repost": false,
        "posted_at": "2026-10-06T07:01:57Z",
        "counters": {
          "reactions": 214,
          "comments": 187,
          "checked_at": "2026-10-06T20:02:27Z"
        },
        "tracking_status": "hot",
        "source": "auto",
        "kol": {
          "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
          "name": "Drew Harper",
          "relationship": "competitor",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/"
        },
        "console_url": "https://app.trytikt.com/posts?post=011c46fa-46b7-45d8-8911-df2f20ea4080",
        "harvest": {
          "state": "paused",
          "paused": true,
          "excluded_reason": "post_paused"
        },
        "performance_vs_usual": 2.07,
        "yield": {
          "people_captured": 14,
          "leads_at_threshold": 0,
          "avg_score_at_threshold": null
        }
      },
      "paused_at": "2026-10-06T19:00:00Z",
      "paused_by": "console"
    }
  }
  ```
</Accordion>

## post.harvest\_resumed

Harvesting a post resumes.

**Data:** `post` ([post](/webhooks/objects#post)) and `resumed_at`.

<Accordion title="Example: post.harvest_resumed">
  ```json theme={null}
  {
    "id": "4132a5fc-52eb-4b7e-893e-c89ca69cacdd",
    "type": "post.harvest_resumed",
    "created_at": "2026-10-06T08:10:07Z",
    "api_version": "2026-10-01",
    "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
    "data": {
      "post": {
        "id": "011c46fa-46b7-45d8-8911-df2f20ea4080",
        "linkedin_post_id": "7450227443607533490",
        "urn": "urn:li:activity:7450227443607533490",
        "url": "https://www.linkedin.com/posts/drew-harper-example_three-mistakes-finance-teams-activity-7450227443607533490-Ab1c",
        "author": {
          "type": "profile",
          "name": "Drew Harper",
          "public_id": "drew-harper-example",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example",
          "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/drew-harper-example"
        },
        "text": "We reviewed 120 finance teams this year. The same three mistakes keep coming back. ➡️ Forecasts built once a quarter, then forgotten. ➡️ Tools bought without an owner. ➡️ Reports nobody reads. Here is the checklist we now use with every new team, step by step, with the questions we ask in the first week and the numbers we look at before anything else.",
        "hashtags": [],
        "media_type": "image",
        "media": {
          "images": [
            "https://media.licdn.com/dms/image/v2/EXAMPLE/feedshare-shrink_1280/0/three-mistakes-finance-teams-1-example"
          ],
          "videos": []
        },
        "external_links": [
          "https://www.example.com/three-mistakes-finance-teams"
        ],
        "is_repost": false,
        "posted_at": "2026-10-06T07:01:57Z",
        "counters": {
          "reactions": 214,
          "comments": 187,
          "checked_at": "2026-10-06T20:02:27Z"
        },
        "tracking_status": "hot",
        "source": "auto",
        "kol": {
          "id": "f6e53743-d2d1-499a-8735-487188ed4edd",
          "name": "Drew Harper",
          "relationship": "competitor",
          "linkedin_url": "https://www.linkedin.com/in/drew-harper-example/"
        },
        "console_url": "https://app.trytikt.com/posts?post=011c46fa-46b7-45d8-8911-df2f20ea4080",
        "harvest": {
          "state": "harvesting",
          "paused": false,
          "excluded_reason": null
        },
        "performance_vs_usual": 2.07,
        "yield": {
          "people_captured": 14,
          "leads_at_threshold": 0,
          "avg_score_at_threshold": null
        }
      },
      "resumed_at": "2026-10-07T09:12:00Z"
    }
  }
  ```
</Accordion>

## post.closed

TIKT stops following a post.

**Data:** `post` ([post](/webhooks/objects#post)), `reason` and `closed_at`. `reason`: `cooled_down` (the post is old enough), or `missing_on_linkedin` (it disappeared from LinkedIn).

<Note>
  A post that was never followed is not sent.
</Note>

<Accordion title="Example: post.closed">
  ```json theme={null}
  {
    "id": "b66dee4c-191a-486f-8aef-7fa9937e2f95",
    "type": "post.closed",
    "created_at": "2026-10-06T08:10:07Z",
    "api_version": "2026-10-01",
    "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
    "data": {
      "post": {
        "id": "4e29e2ca-1f75-4d6f-8f23-692956d9c949",
        "linkedin_post_id": "7435354408163047384",
        "urn": "urn:li:activity:7435354408163047384",
        "url": "https://www.linkedin.com/posts/avery-collins-example_the-finance-playbook-activity-7435354408163047384-Ab1c",
        "author": {
          "type": "profile",
          "name": "Avery Collins",
          "public_id": "avery-collins-example",
          "linkedin_url": "https://www.linkedin.com/in/avery-collins-example",
          "avatar_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-scale_400_400/0/avery-collins-example"
        },
        "text": "The finance playbook we wish we had on day one is finally public. Twenty templates across five stages: plan, operate, close, decide, report. Comment PLAYBOOK and I'll send it over 👇",
        "hashtags": [],
        "media_type": "image",
        "media": {
          "images": [
            "https://media.licdn.com/dms/image/v2/EXAMPLE/feedshare-shrink_1280/0/the-finance-playbook-1-example"
          ],
          "videos": []
        },
        "external_links": [
          "https://www.example.com/the-finance-playbook"
        ],
        "is_repost": false,
        "posted_at": "2026-10-06T07:01:57Z",
        "counters": {
          "reactions": 214,
          "comments": 187,
          "checked_at": "2026-10-06T20:02:27Z"
        },
        "tracking_status": "closed",
        "source": "auto",
        "kol": {
          "id": "b2905fad-ec45-4372-8785-cb41295dafb6",
          "name": "Avery Collins",
          "relationship": "competitor",
          "linkedin_url": "https://www.linkedin.com/in/avery-collins-example/"
        },
        "console_url": "https://app.trytikt.com/posts?post=4e29e2ca-1f75-4d6f-8f23-692956d9c949",
        "harvest": {
          "state": "closed",
          "paused": false,
          "excluded_reason": null
        },
        "performance_vs_usual": 2.07,
        "yield": {
          "people_captured": 14,
          "leads_at_threshold": 0,
          "avg_score_at_threshold": null
        }
      },
      "reason": "cooled_down",
      "closed_at": "2026-10-09T08:02:00Z"
    }
  }
  ```
</Accordion>


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