> ## 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.
# List events
> Leads added to or removed from your lists, and the lists themselves.
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.
## list.lead\_added
A lead is added to a list, by hand or by a workflow.
**Data:** `list` (`{id, name, created_at, lead_count}`), `lead` ([lead](/webhooks/objects#lead)) and `added_at`.
```json theme={null}
{
"id": "d1b4787a-4f1d-48a2-8aee-127aab17703e",
"type": "list.lead_added",
"created_at": "2026-10-06T11:48:34Z",
"api_version": "2026-10-01",
"workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
"data": {
"list": {
"id": "5839bad9-feaa-40f3-8c3c-6d919dbe7d64",
"name": "Follow up this week",
"created_at": "2026-09-23T21:08:49Z",
"lead_count": 11
},
"lead": {
"id": "79ef025c-2c32-4f0d-8600-8cf3f8816a6b",
"status": "active",
"score": 3,
"score_max": 5,
"fit_band": "good",
"criteria": [
{
"key": "job_role",
"label": "Job title",
"mode": "weighted",
"verdict": "no",
"justification": "Head of Finance is not one of the job roles this ICP targets."
},
{
"key": "location",
"label": "Location",
"mode": "strict",
"verdict": "yes",
"justification": "Chicago, United States is inside the target locations."
},
{
"key": "company_type",
"label": "Company type",
"mode": "weighted",
"verdict": "yes",
"justification": "Contoso Finance is privately held, a target company type."
},
{
"key": "company_size",
"label": "Company size",
"mode": "weighted",
"verdict": "yes",
"justification": "Contoso Finance has 120 employees, inside the 50 to 1,000 range."
},
{
"key": "industry",
"label": "Industry",
"mode": "weighted",
"verdict": "no",
"justification": "Contoso Finance works in Financial Services, not a target industry."
}
],
"disqualifiers": [],
"summary": "The location, company type, company size match; the industry and job title do not.",
"scored_at": "2026-10-06T08:10:06Z",
"scoring_version": "criteria-v2-en",
"icp_version_id": "e18507fb-b82e-48a9-8616-dbe2793d98dc",
"engagement_count": 2,
"reaction_count": 1,
"comment_count": 1,
"signals": [
{
"id": "09d1d376-1f85-47f5-8a1c-dae1c9115b50",
"kind": "reaction",
"reaction_type": "LIKE",
"text": null,
"url": null,
"likes": 0,
"replies": 0,
"is_pinned": false,
"is_edited": false,
"occurred_at": null,
"captured_at": "2026-10-06T08:04:25Z",
"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": "hot",
"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"
}
},
{
"id": "f4676404-e97e-4ba3-80a4-e925bb6e72f3",
"kind": "comment",
"reaction_type": null,
"text": "PLAYBOOK, please. We are rebuilding our close this quarter.",
"url": "https://www.linkedin.com/feed/update/urn:li:activity:7435354408163047384?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7435354408163047384%2C7443967071729609847%29",
"likes": 0,
"replies": 0,
"is_pinned": false,
"is_edited": false,
"occurred_at": "2026-10-06T06:46:51Z",
"captured_at": "2026-10-06T08:04:25Z",
"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": "hot",
"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"
}
}
],
"first_seen_at": "2026-10-06T08:10:06Z",
"last_engagement_at": "2026-10-06T08:04:25Z",
"status_changed_at": null,
"lists": [
{
"id": "5839bad9-feaa-40f3-8c3c-6d919dbe7d64",
"name": "Follow up this week",
"added_at": "2026-10-06T11:48:34Z"
}
],
"handled": true,
"console_url": "https://app.trytikt.com/leads?lead=79ef025c-2c32-4f0d-8600-8cf3f8816a6b",
"person": {
"id": "8cc35903-8f9b-4424-83f6-590fd144dd2b",
"linkedin_url": "https://www.linkedin.com/in/sam-patel-example/",
"linkedin_member_id": "ACoAAExampleg3aqeynohhxisdfmw4ycl729apjr",
"full_name": "Sam Patel",
"first_name": "Sam",
"last_name": "Patel",
"headline": "Head of Finance at Contoso Finance",
"about": "Head of Finance at Contoso Finance. Numbers, people, and the occasional spreadsheet.",
"picture_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-shrink_800_800/0/sam-patel-example",
"location": {
"country": "United States",
"country_code": "US",
"region": "Illinois",
"city": "Chicago"
},
"current_position": {
"title": "Head of Finance",
"company_name": "Contoso Finance",
"company_linkedin_url": "https://www.linkedin.com/company/contoso-finance-example/"
},
"seniority": "manager",
"department": null,
"positions": [
{
"title": "Head of Finance",
"company_name": "Contoso Finance",
"company_linkedin_url": "https://www.linkedin.com/company/contoso-finance-example/",
"company_linkedin_id": "71047941",
"start_date": "2026-03",
"end_date": null,
"is_current": true,
"duration": "8 mos",
"location": null,
"employment_type": null,
"workplace_type": null,
"description": null
},
{
"title": "Finance Manager",
"company_name": "Tailspin Data",
"company_linkedin_url": "https://www.linkedin.com/company/tailspin-data-example/",
"company_linkedin_id": "71525700",
"start_date": "2021-02",
"end_date": "2023-03",
"is_current": false,
"duration": "3 yrs 2 mos",
"location": null,
"employment_type": null,
"workplace_type": null,
"description": null
}
],
"education": [
{
"school_name": "Example State University",
"school_linkedin_url": null,
"degree": "Master of Science",
"field_of_study": "Finance",
"start_year": 2006,
"end_year": 2010
},
{
"school_name": "Riverside College",
"school_linkedin_url": null,
"degree": "Bachelor of Arts",
"field_of_study": "Economics",
"start_year": 2004,
"end_year": 2006
}
],
"languages": [
{
"name": "English",
"proficiency": "Native or bilingual proficiency"
},
{
"name": "Spanish",
"proficiency": "Elementary proficiency"
}
],
"skills": [
"Financial planning",
"Forecasting"
],
"followers_count": 582,
"connections_count": 574,
"flags": {
"open_to_work": false,
"is_hiring": false,
"is_premium": true,
"is_influencer": false,
"is_verified": true,
"is_creator": false
},
"profile_language": "en",
"profile_country": "US",
"websites": [],
"linkedin_member_since": "2009-05-14T00:00:00Z",
"profile_read_at": "2026-10-06T08:05:12Z"
},
"company": {
"id": "8cd0112a-bc87-460a-8558-6f23c9c571cd",
"linkedin_company_id": "71047941",
"name": "Contoso Finance",
"universal_name": "contoso-finance",
"linkedin_url": "https://www.linkedin.com/company/contoso-finance-example",
"website": "https://www.contoso-finance.example/",
"domain": "contoso-finance.example",
"logo_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/company-logo_200_200/0/contoso-finance-example",
"tagline": "Outsourced finance for growing companies.",
"about": "Contoso Finance runs accounting, payroll and reporting for growing companies, so their founders can stay on the product.",
"industry": "Financial Services",
"specialties": [],
"company_size": "51-200 employees",
"employees_count": 120,
"organization_type": "Privately Held",
"founded_year": 2011,
"followers_count": 4310,
"headquarters": "Chicago, Illinois",
"country_code": "US",
"locations": [
"200 Sample Avenue, Chicago, Illinois 60601, US"
],
"enriched_at": "2026-10-01T21:43:10Z"
}
},
"added_at": "2026-10-06T11:48:34Z"
}
}
```
## list.lead\_removed
A lead is removed from a list.
**Data:** `list` (`{id, name}`), `lead` ([lead](/webhooks/objects#lead)) and `removed_at`.
Not sent for each lead when the list itself is deleted: `list.deleted` says it once.
```json theme={null}
{
"id": "280f0f2c-8e89-484e-85e8-e5cf8ef41dab",
"type": "list.lead_removed",
"created_at": "2026-10-06T18:40:12Z",
"api_version": "2026-10-01",
"workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
"data": {
"list": {
"id": "5839bad9-feaa-40f3-8c3c-6d919dbe7d64",
"name": "Follow up this week"
},
"lead": {
"id": "79ef025c-2c32-4f0d-8600-8cf3f8816a6b",
"status": "active",
"score": 3,
"score_max": 5,
"fit_band": "good",
"criteria": [
{
"key": "job_role",
"label": "Job title",
"mode": "weighted",
"verdict": "no",
"justification": "Head of Finance is not one of the job roles this ICP targets."
},
{
"key": "location",
"label": "Location",
"mode": "strict",
"verdict": "yes",
"justification": "Chicago, United States is inside the target locations."
},
{
"key": "company_type",
"label": "Company type",
"mode": "weighted",
"verdict": "yes",
"justification": "Contoso Finance is privately held, a target company type."
},
{
"key": "company_size",
"label": "Company size",
"mode": "weighted",
"verdict": "yes",
"justification": "Contoso Finance has 120 employees, inside the 50 to 1,000 range."
},
{
"key": "industry",
"label": "Industry",
"mode": "weighted",
"verdict": "no",
"justification": "Contoso Finance works in Financial Services, not a target industry."
}
],
"disqualifiers": [],
"summary": "The location, company type, company size match; the industry and job title do not.",
"scored_at": "2026-10-06T08:10:06Z",
"scoring_version": "criteria-v2-en",
"icp_version_id": "e18507fb-b82e-48a9-8616-dbe2793d98dc",
"engagement_count": 2,
"reaction_count": 1,
"comment_count": 1,
"signals": [
{
"id": "09d1d376-1f85-47f5-8a1c-dae1c9115b50",
"kind": "reaction",
"reaction_type": "LIKE",
"text": null,
"url": null,
"likes": 0,
"replies": 0,
"is_pinned": false,
"is_edited": false,
"occurred_at": null,
"captured_at": "2026-10-06T08:04:25Z",
"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": "hot",
"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"
}
},
{
"id": "f4676404-e97e-4ba3-80a4-e925bb6e72f3",
"kind": "comment",
"reaction_type": null,
"text": "PLAYBOOK, please. We are rebuilding our close this quarter.",
"url": "https://www.linkedin.com/feed/update/urn:li:activity:7435354408163047384?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7435354408163047384%2C7443967071729609847%29",
"likes": 0,
"replies": 0,
"is_pinned": false,
"is_edited": false,
"occurred_at": "2026-10-06T06:46:51Z",
"captured_at": "2026-10-06T08:04:25Z",
"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": "hot",
"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"
}
}
],
"first_seen_at": "2026-10-06T08:10:06Z",
"last_engagement_at": "2026-10-06T08:04:25Z",
"status_changed_at": null,
"lists": [],
"handled": false,
"console_url": "https://app.trytikt.com/leads?lead=79ef025c-2c32-4f0d-8600-8cf3f8816a6b",
"person": {
"id": "8cc35903-8f9b-4424-83f6-590fd144dd2b",
"linkedin_url": "https://www.linkedin.com/in/sam-patel-example/",
"linkedin_member_id": "ACoAAExampleg3aqeynohhxisdfmw4ycl729apjr",
"full_name": "Sam Patel",
"first_name": "Sam",
"last_name": "Patel",
"headline": "Head of Finance at Contoso Finance",
"about": "Head of Finance at Contoso Finance. Numbers, people, and the occasional spreadsheet.",
"picture_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/profile-displayphoto-shrink_800_800/0/sam-patel-example",
"location": {
"country": "United States",
"country_code": "US",
"region": "Illinois",
"city": "Chicago"
},
"current_position": {
"title": "Head of Finance",
"company_name": "Contoso Finance",
"company_linkedin_url": "https://www.linkedin.com/company/contoso-finance-example/"
},
"seniority": "manager",
"department": null,
"positions": [
{
"title": "Head of Finance",
"company_name": "Contoso Finance",
"company_linkedin_url": "https://www.linkedin.com/company/contoso-finance-example/",
"company_linkedin_id": "71047941",
"start_date": "2026-03",
"end_date": null,
"is_current": true,
"duration": "8 mos",
"location": null,
"employment_type": null,
"workplace_type": null,
"description": null
},
{
"title": "Finance Manager",
"company_name": "Tailspin Data",
"company_linkedin_url": "https://www.linkedin.com/company/tailspin-data-example/",
"company_linkedin_id": "71525700",
"start_date": "2021-02",
"end_date": "2023-03",
"is_current": false,
"duration": "3 yrs 2 mos",
"location": null,
"employment_type": null,
"workplace_type": null,
"description": null
}
],
"education": [
{
"school_name": "Example State University",
"school_linkedin_url": null,
"degree": "Master of Science",
"field_of_study": "Finance",
"start_year": 2006,
"end_year": 2010
},
{
"school_name": "Riverside College",
"school_linkedin_url": null,
"degree": "Bachelor of Arts",
"field_of_study": "Economics",
"start_year": 2004,
"end_year": 2006
}
],
"languages": [
{
"name": "English",
"proficiency": "Native or bilingual proficiency"
},
{
"name": "Spanish",
"proficiency": "Elementary proficiency"
}
],
"skills": [
"Financial planning",
"Forecasting"
],
"followers_count": 582,
"connections_count": 574,
"flags": {
"open_to_work": false,
"is_hiring": false,
"is_premium": true,
"is_influencer": false,
"is_verified": true,
"is_creator": false
},
"profile_language": "en",
"profile_country": "US",
"websites": [],
"linkedin_member_since": "2009-05-14T00:00:00Z",
"profile_read_at": "2026-10-06T08:05:12Z"
},
"company": {
"id": "8cd0112a-bc87-460a-8558-6f23c9c571cd",
"linkedin_company_id": "71047941",
"name": "Contoso Finance",
"universal_name": "contoso-finance",
"linkedin_url": "https://www.linkedin.com/company/contoso-finance-example",
"website": "https://www.contoso-finance.example/",
"domain": "contoso-finance.example",
"logo_url": "https://media.licdn.com/dms/image/v2/EXAMPLE/company-logo_200_200/0/contoso-finance-example",
"tagline": "Outsourced finance for growing companies.",
"about": "Contoso Finance runs accounting, payroll and reporting for growing companies, so their founders can stay on the product.",
"industry": "Financial Services",
"specialties": [],
"company_size": "51-200 employees",
"employees_count": 120,
"organization_type": "Privately Held",
"founded_year": 2011,
"followers_count": 4310,
"headquarters": "Chicago, Illinois",
"country_code": "US",
"locations": [
"200 Sample Avenue, Chicago, Illinois 60601, US"
],
"enriched_at": "2026-10-01T21:43:10Z"
}
},
"removed_at": "2026-10-06T18:40:12Z"
}
}
```
## list.created
A list is created.
**Data:** `list`: `{id, name, created_at, lead_count}`, with `lead_count` at 0.
```json theme={null}
{
"id": "e9b49c10-17fa-42d4-815c-d5e0e4e36a8c",
"type": "list.created",
"created_at": "2026-09-22T14:17:18Z",
"api_version": "2026-10-01",
"workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
"data": {
"list": {
"id": "0edab928-c58e-4d61-8feb-4c3000a7f44b",
"name": "Best fit",
"created_at": "2026-09-22T14:17:18Z",
"lead_count": 0
}
}
}
```
## list.renamed
A list is renamed.
**Data:** `list`: `{id, name, previous_name}`.
```json theme={null}
{
"id": "812a9a50-5f60-4b78-8f4a-7edc9a277340",
"type": "list.renamed",
"created_at": "2026-10-06T08:10:07Z",
"api_version": "2026-10-01",
"workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
"data": {
"list": {
"id": "0edab928-c58e-4d61-8feb-4c3000a7f44b",
"name": "Best fit — Q4",
"previous_name": "Best fit"
}
}
}
```
## list.deleted
A list is deleted. Its leads stay in your workspace.
**Data:** `list`: `{id, name, lead_count}`, the number of leads it held.
```json theme={null}
{
"id": "1d127ece-3a67-4970-813a-0279ee1924ac",
"type": "list.deleted",
"created_at": "2026-10-06T08:10:07Z",
"api_version": "2026-10-01",
"workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
"data": {
"list": {
"id": "0edab928-c58e-4d61-8feb-4c3000a7f44b",
"name": "Best fit",
"lead_count": 11
}
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.