# LinkedIn webhooks

LinkedIn webhooks are signed JSON POSTs that LinkedIn sends about lead form responses, activity on Company Pages, and job and candidate events in its Talent products.

Agent skill: `npx skills add hookdeck/webhook-skills --skill linkedin-webhooks` ([details](https://hookdeck.com/webhooks/linkedin/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [LinkedIn's official docs](https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications).

[Overview](https://hookdeck.com/webhooks/linkedin) · [Webhook events (9)](https://hookdeck.com/webhooks/linkedin/events) · [MCP events](https://hookdeck.com/webhooks/linkedin/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/linkedin/verify) · [Production guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/linkedin/skill)

## Key facts

| Fact | Value | Source |
|---|---|---|
| Signature header | `X-LI-Signature` Format: <lowercase hex> | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation) |
| Scheme | `HMAC-SHA256` **Docs discrepancy:** The Apply Connect page says to add the `hmacsha256=` prefix to your computed signature for a complete match. The shared Webhooks page says the header holds only the hex digest, and the sample headers on the Talent pages are bare hex. Follow the shared page, and hash the bytes as received. ([docs](https://learn.microsoft.com/en-us/linkedin/talent/apply-connect/receive-applications)) | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation) |
| Signed material | `hmacsha256={raw body}` The literal string hmacsha256=, then the POST body exactly as received, with no timestamp added. The prefix never appears in the header. | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation) |
| How events are identified | `type field in the body; leadAction or action says what happened` | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/marketing/lead-sync/leadsync) |
| Body format | `JSON` Content type: application/json. | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/talent/receive-push-events) |
| Event families | `Lead Sync notifications, Organization social action notifications, Talent Apply Connect applications, Talent Job Posting callbacks, Talent Middleware push events` | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/marketing/lead-sync/leadsync) |
| URL handshake | `GET: sign the challenge` HTTP 200 within 3 seconds, with Content-Type: application/json and a JSON body holding challengeCode and challengeResponse, the lowercase hex HMAC-SHA256 of the challengeCode keyed with your clientSecret. After 3 failed re-validations in a row, the endpoint is blocked. | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation) |
| Envelope | `type` | [LinkedIn docs](https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications) |
| Agent skill | `npx skills add hookdeck/webhook-skills --skill linkedin-webhooks` | [Agent skill →](https://hookdeck.com/webhooks/linkedin/skill) |

[Verify LinkedIn webhooks](https://hookdeck.com/webhooks/linkedin/verify)

## How LinkedIn webhooks work

Webhooks save you polling LinkedIn's APIs for changes, but they're only open to apps with an approved use case, and each product has its own access and its own way to register a URL. Lead Sync, Community Management, Apply Connect, Job Posting, Recruiter System Connect and CRM Connect are separate, so most apps only ever see a few of these events. LinkedIn sends a GET challenge before it delivers anything, then repeats it about every 2 hours, and blocks the endpoint after 3 failures in a row.

Each delivery is a JSON POST, and `type` in the body names the event. `LEAD_ACTION` has a `leadAction` of `CREATED` or `DELETED`. `ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS` holds a `notifications` array in batches of up to 10, each with its own `action`. Many Talent events carry only an id that you use to fetch the details with a second API call. There is no version header or field on a delivery.

## Setting up LinkedIn webhooks

- For Community Management and Job Posting, register your URL in the Webhooks tab of your app in the [Developer Portal](https://www.linkedin.com/developers/apps), which only appears with an approved webhook use case. Community Management then needs a `PUT /rest/eventSubscriptions` for each member.
- Lead Sync can't be set up in the portal: create the subscription with `POST /rest/leadNotifications`, and LinkedIn recommends doing it per owner. Apply Connect takes a `jobApplicationWebhookUrl` in the job payload, and Recruiter System Connect takes callback URLs during customer configuration.
- LinkedIn needs a public HTTPS URL and doesn't support ngrok. It recommends testing with serverless functions on a cloud provider, or you can forward to localhost from an Event Gateway source with the [Hookdeck CLI](/docs/cli). Campaign Manager can generate test leads.
- LinkedIn's docs describe no way to resend a delivery. You can re-run validation from the portal, and Community Management keeps notifications you can pull for 60 days.

## Delivery behaviour

- **Timeout:** 3s for the challenge. no timeout is documented for a POST delivery. [Guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#timeouts)
- **Retries:** varies by product. Community Management: every 5 minutes for 8 hours. [Guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#retries)
- **After retries:** varies by product. Community Management keeps 60 days to pull; Talent push events are dropped. [Guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#retries)
- **Duplicates:** expected. the key differs by product, and Lead Sync has no notification id. [Guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#duplicates)

## Known failure modes

1. **No webhooks ever arrive.** LinkedIn only sends to a URL that has passed its GET challenge, so a POST-only route never receives an event. Return `challengeCode` and an HMAC of it as `challengeResponse` within 3 seconds, as JSON with a `200`. [Testing your endpoint](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#testing)
2. **The endpoint stops receiving events after working for weeks.** LinkedIn re-validates about every 2 hours and blocks an endpoint after 3 failures in a row, so a few hours of downtime can stop delivery. Fix the cause, then re-run validation from the Developer Portal. [Retries and blocked endpoints](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#retries)
3. **Lead Sync deliveries have no notificationId.** LinkedIn's general advice is to deduplicate on the notification ID, but `LEAD_ACTION` doesn't have one. Use `leadGenFormResponse` and `occurredAt` together, because one member's register and unregister actions share a response URN. [Handle duplicates](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#duplicates)
4. **Community Management notifications stop for one member.** A subscription lasts only as long as the member's grant and admin role, and LinkedIn's docs describe no event when it's removed. Check subscriptions on a schedule, resubscribe, then query the notifications you missed. [Choosing events](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#choosing-events)

From [Hookdeck's LinkedIn guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts).

## LinkedIn webhook best practices

- **[Verify every signature](https://hookdeck.com/webhooks/linkedin/verify).** Compute the HMAC over `hmacsha256=` plus the raw body with your `clientSecret`, so a forged POST can't reach your handler.
- **[Keep the challenge handler small](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#timeouts).** It has 3 seconds to respond, about every 2 hours, so it should do nothing except compute one HMAC.
- **[Return a 200 and process in the background](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#timeouts).** The shared docs accept any 2xx, but the Talent pages only treat a 200 as success, so a 200 is safe everywhere.
- **[Use the right duplicate key for each product](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#duplicates).** `notificationId` only exists on Community Management. Lead Sync needs `leadGenFormResponse` and `occurredAt` together.
- **[Act on the warning emails](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#retries).** LinkedIn emails the app's developers about each failed validation, and that's your chance to fix it before the endpoint is blocked.
- **[Track subscriptions for each member](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts#choosing-events).** A Community Management subscription ends when the member's grant lapses or they stop being an admin, and LinkedIn's docs describe no event for it.

## Common LinkedIn webhook events

### Lead Sync

- [LEAD_ACTION](https://hookdeck.com/webhooks/linkedin/events#LEAD_ACTION): Lead form response is created or deleted

### Community Management

- [ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS](https://hookdeck.com/webhooks/linkedin/events#ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS): Likes, comments, shares or mentions on a Company Page

### Talent

- [EXPORT_JOB_APPLICATION](https://hookdeck.com/webhooks/linkedin/events#EXPORT_JOB_APPLICATION): Applicant submits an application to your posted job
- [JOB_POSTING_STATUS](https://hookdeck.com/webhooks/linkedin/events#JOB_POSTING_STATUS): Job's listing, Easy Apply or promotion status changes
- [EXPORT_CANDIDATE_PROFILE](https://hookdeck.com/webhooks/linkedin/events#EXPORT_CANDIDATE_PROFILE): Candidate is exported from Recruiter to your ATS or CRM

## Events by resource

| Resource | Events | Payloads |
|---|---|---|
| [talent](https://hookdeck.com/webhooks/linkedin/events#resource-talent) | 7 | 7 |

1 more resource. [All 9 events](https://hookdeck.com/webhooks/linkedin/events)

## In this hub

- [Webhook events](https://hookdeck.com/webhooks/linkedin/events): Every covered LinkedIn event, with payloads where the registry has them.
- [MCP events](https://hookdeck.com/webhooks/linkedin/mcp-events): How an agent subscribes to LinkedIn events as MCP events.
- [Verify signatures](https://hookdeck.com/webhooks/linkedin/verify): Signature facts, verification code and common failures.
- [Production guide](https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts): Production problems: timeouts, duplicates, ordering and retries, and how to handle them.
- [Agent skill](https://hookdeck.com/webhooks/linkedin/skill): Install the webhook skill in your coding agent. `npx skills add hookdeck/webhook-skills --skill linkedin-webhooks`
---

Not affiliated with LinkedIn. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/linkedin.json) · [Report a correction](https://hookdeck.com/contact)
