LinkedIn Webhooks

When to Use This Skill

• How do I receive LinkedIn webhooks?
• How do I pass the LinkedIn challengeCode endpoint validation?
• How do I verify the LinkedIn X-LI-Signature header?
• Why is my LinkedIn webhook signature verification failing?
• How do I handle LinkedIn LEAD_ACTION or ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS events?

LinkedIn webhooks are two endpoints on one URL:

1. GET — endpoint validation. LinkedIn sends ?challengeCode=<uuid> and you echo back a JSON challengeResponse. Re-run every 2 hours; 3 consecutive failures block the endpoint.
2. POST — event delivery. Each request carries an X-LI-Signature header you must verify.

Both use HMAC-SHA256 keyed with your app's clientSecret, hex-encoded. LinkedIn does not follow the Standard Webhooks spec, and there is no linkedin-api-client SDK method for webhook verification — verify manually.

Verification (core)