{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with LinkedIn.",
  "vendor": "linkedin",
  "name": "LinkedIn",
  "official_docs": "https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications",
  "docs_checked": "2026-10-18",
  "url": "https://hookdeck.com/webhooks/linkedin",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/linkedin"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/linkedin/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/linkedin/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/linkedin/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/linkedin/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/linkedin/skill"
    }
  ],
  "summary": "LinkedIn signs every webhook with X-LI-Signature (HMAC-SHA256, despite what the docs say).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-LI-Signature",
      "detail": "Format: <lowercase hex>",
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation"
      },
      "doc_discrepancy": {
        "claim": "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.",
        "url": "https://learn.microsoft.com/en-us/linkedin/talent/apply-connect/receive-applications",
        "confirmed": false
      }
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "hmacsha256={raw body}",
      "detail": "The literal string hmacsha256=, then the POST body exactly as received, with no timestamp added. The prefix never appears in the header.",
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "type field in the body; leadAction or action says what happened",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/marketing/lead-sync/leadsync"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/talent/receive-push-events"
      },
      "doc_discrepancy": null
    },
    {
      "key": "families",
      "label": "Event families",
      "value": "Lead Sync notifications, Organization social action notifications, Talent Apply Connect applications, Talent Job Posting callbacks, Talent Middleware push events",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/marketing/lead-sync/leadsync"
      },
      "doc_discrepancy": null
    },
    {
      "key": "handshake",
      "label": "URL handshake",
      "value": "GET: sign the challenge",
      "detail": "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.",
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "type",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "LinkedIn docs",
        "href": "https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill linkedin-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/linkedin/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://learn.microsoft.com/en-us/linkedin/shared/api-guide/webhook-validation",
    "checked": "2026-11-04"
  },
  "counts": {
    "events": 9,
    "with_payload": 9,
    "captured": 0,
    "with_description": 9,
    "resources": 2,
    "confidence": {
      "verified": 0,
      "documented": 9,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any LinkedIn event"
  },
  "events": [
    {
      "name": "LEAD_ACTION",
      "resource": "lead",
      "description": "Lead form response is created or deleted",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#LEAD_ACTION",
      "json": "https://hookdeck.com/webhooks/linkedin/events/lead-action.json"
    },
    {
      "name": "ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS",
      "resource": "organization_social_action",
      "description": "Likes, comments, shares or mentions on a Company Page",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS",
      "json": "https://hookdeck.com/webhooks/linkedin/events/organization-social-action-notifications.json"
    },
    {
      "name": "EXPORT_CANDIDATE_PROFILE",
      "resource": "talent",
      "description": "Candidate is exported from Recruiter to your ATS or CRM",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#EXPORT_CANDIDATE_PROFILE",
      "json": "https://hookdeck.com/webhooks/linkedin/events/export-candidate-profile.json"
    },
    {
      "name": "EXPORT_APPLICATION_EVALUATION",
      "resource": "talent",
      "description": "LinkedIn evaluates an application for your job posting",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#EXPORT_APPLICATION_EVALUATION",
      "json": "https://hookdeck.com/webhooks/linkedin/events/export-application-evaluation.json"
    },
    {
      "name": "EXPORT_JOB_APPLICATION",
      "resource": "talent",
      "description": "Applicant submits an application to your posted job",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#EXPORT_JOB_APPLICATION",
      "json": "https://hookdeck.com/webhooks/linkedin/events/export-job-application.json"
    },
    {
      "name": "JOB_POSTING_STATUS",
      "resource": "talent",
      "description": "Job's listing, Easy Apply or promotion status changes",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#JOB_POSTING_STATUS",
      "json": "https://hookdeck.com/webhooks/linkedin/events/job-posting-status.json"
    },
    {
      "name": "RESYNC_JOBS",
      "resource": "talent",
      "description": "LinkedIn asks you to re-sync one or more jobs",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#RESYNC_JOBS",
      "json": "https://hookdeck.com/webhooks/linkedin/events/resync-jobs.json"
    },
    {
      "name": "INTEGRATION_STATUS_CHANGE",
      "resource": "talent",
      "description": "Customer enables a Recruiter System Connect integration",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#INTEGRATION_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/linkedin/events/integration-status-change.json"
    },
    {
      "name": "DELETE_PROSPECT_NOTE",
      "resource": "talent",
      "description": "Recruiter prospect note is deleted",
      "confidence": "documented",
      "schema_source": "from LinkedIn docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linkedin/events#DELETE_PROSPECT_NOTE",
      "json": "https://hookdeck.com/webhooks/linkedin/events/delete-prospect-note.json"
    }
  ]
}