Event reference

LinkedIn engagement events

The event for one person who reacted to or commented on a competitor's LinkedIn post: every key, the company fields and an example.

An engagement event fires when a person reacts to or comments on one of a tracked competitor's newest LinkedIn posts. One person on one post is one event.

eventType: engagement
subEventType: linkedin_engagement
signalType: engagement.new (also engagement.updated, engagement.removed in the schema)
Platform field: engagementResponse (same value as metadata)
Tracker: LinkedIn engagement
relevance: Not scored: { "status": "unjudged" }

How to read this page

Every event has the common fields plus one engagementResponse object, sent twice (also as metadata). It has the item fields and a platform, then the keys below. The item author is the person who engaged, not the competitor.

engagementResponse

engagementResponse · linkedin

platform

'linkedin'

Always linkedin.

personHandle

string

LinkedIn's id for the person. Stable across events: use it to dedupe people.

name

string

The person's name.

headline

string|null

The person's LinkedIn headline. null when LinkedIn omits it.

profileUrl

string

The person's LinkedIn profile.

imageUrl

string|null

The person's photo. null when LinkedIn sends none. Photo links expire after a few weeks.

companyName

string|null

The company the person works at. null when Signals cannot find one.

companyDomain

string|null

That company's website domain, for example hubspot.com. null when not found.

companyLinkedinUrl

string|null

That company's LinkedIn page. null when not found.

how

'reacted'|'commented'

How the person engaged.

reaction

string|null

The reaction type (LIKE, PRAISE, ENTERTAINMENT, …) when how is reacted. Otherwise null.

commentText

string|null

The comment when how is commented. Otherwise null.

postUrn

string

LinkedIn's id for the competitor's post.

postUrl

string

A link to the competitor's post.

postTitle

string|null

The first line of the post.

The item fields repeat the person: title is the name, text is the headline, url and author.url are the profile link. media is empty and metrics is {}.

Event · linkedin_engagementSample with the exact shape (no real run yet)

json

1{
2  "version": 1,
3  "eventId": "1742a36b-08e8-477d-8f35-10b3d6207930",
4  "eventType": "engagement",
5  "subEventType": "linkedin_engagement",
6  "action": "new",
7  "signalType": "engagement.new",
8  "source": "linkedin_engagement",
9  "orgId": "org_3KikADUjsyXrUJ4RJhWpwcp98Yf",
10  "trackerId": "271e9142-1ab6-41ad-b905-3d58e065e71d",
11  "runId": "57a0369d-23f8-4aa5-86db-6c64b3cea6e4",
12  "competitor": {
13    "name": "HubSpot",
14    "domain": "hubspot.com",
15    "subjectKey": "engagement:hubspot|posts:5"
16  },
17  "occurredAt": "2026-10-27T20:28:38.954Z",
18  "detectedAt": "2026-10-27T20:28:38.954Z",
19  "sequence": 27,
20  "itemKey": "linkedin_engagement-7520919497038557184-priya-shah",
21  "relevance": {
22    "status": "unjudged"
23  },
24  "engagementResponse": {
25    "platform": "linkedin",
26    "title": "Priya Shah",
27    "text": "B2B Marketing Strategy | Lifecycle Operations",
28    "url": "https://www.linkedin.com/in/priya-shah",
29    "author": {
30      "name": "Priya Shah",
31      "handle": "priya-shah",
32      "url": "https://www.linkedin.com/in/priya-shah",
33      "imageUrl": null
34    },
35    "media": [],
36    "metrics": {},
37    "personHandle": "priya-shah",
38    "name": "Priya Shah",
39    "headline": "B2B Marketing Strategy | Lifecycle Operations",
40    "profileUrl": "https://www.linkedin.com/in/priya-shah",
41    "imageUrl": null,
42    "companyName": "Example Inc.",
43    "companyDomain": "example.com",
44    "companyLinkedinUrl": "https://www.linkedin.com/company/example/",
45    "how": "reacted",
46    "reaction": "ENTERTAINMENT",
47    "commentText": null,
48    "postUrn": "7520919497038557184",
49    "postUrl": "https://www.linkedin.com/feed/update/urn:li:activity:7520919497038557184/",
50    "postTitle": "Which of these is “frighteningly” on brand? 👻"
51  },
52  "metadata": {
53    "platform": "linkedin",
54    "title": "Priya Shah",
55    "text": "B2B Marketing Strategy | Lifecycle Operations",
56    "url": "https://www.linkedin.com/in/priya-shah",
57    "author": {
58      "name": "Priya Shah",
59      "handle": "priya-shah",
60      "url": "https://www.linkedin.com/in/priya-shah",
61      "imageUrl": null
62    },
63    "media": [],
64    "metrics": {},
65    "personHandle": "priya-shah",
66    "name": "Priya Shah",
67    "headline": "B2B Marketing Strategy | Lifecycle Operations",
68    "profileUrl": "https://www.linkedin.com/in/priya-shah",
69    "imageUrl": null,
70    "companyName": "Example Inc.",
71    "companyDomain": "example.com",
72    "companyLinkedinUrl": "https://www.linkedin.com/company/example/",
73    "how": "reacted",
74    "reaction": "ENTERTAINMENT",
75    "commentText": null,
76    "postUrn": "7520919497038557184",
77    "postUrl": "https://www.linkedin.com/feed/update/urn:li:activity:7520919497038557184/",
78    "postTitle": "Which of these is “frighteningly” on brand? 👻"
79  }
80}

How you get these events

A LinkedIn engagement run sends one run webhook with eventType: "engagement" and the sections engagement.new and engagement.updated. Read the pages of each section: every item is one event like the one above.

Find switchers

Turn engaged people into outreach.

Mentions

People who write about the competitor.