generated: '2026-10-18'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.linkupapi.com/api-reference/v2/webhooks/introduction.md
sources:
- https://docs.linkupapi.com/api-reference/v2/webhooks/introduction.md
- https://docs.linkupapi.com/api-reference/v2/webhooks/create.md
- https://docs.linkupapi.com/api-reference/v2/webhooks/list.md
- https://docs.linkupapi.com/api-reference/v2/webhooks/update.md
description: LinkupAPI webhook event surface
events:
- event: message_received
  description: A new message (LinkedIn) or email was received — use the top‑level `platform` field to tell the two channels apart.
- event: accepted_invitation
  description: One or more connection requests you sent were accepted.
- event: invitation_received
  description: The account received one or more new connection requests.
- event: email_bounced
  description: An email you sent bounced.
- event: message_read
  description: A participant has seen one of the account's messages (LinkedIn and WhatsApp read receipts, opt‑in).
- event: message_delivered
  description: A message the account sent reached the recipient's phone (WhatsApp delivery receipt, opt‑in).
- event: message_failed
  description: WhatsApp could not deliver a message the account sent (opt‑in).
- event: disconnection
  description: Fires whenever the underlying platform session expires so you can react (re‑auth, alert, etc.).
delivery:
  signature: 'Optional HMAC‑SHA256 signature; enable with `enable_signature: true` at webhook creation. The payload is signed and the secret is
    returned once.'
  retries: 'At‑least‑once delivery with backoff schedule: 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts total). Retries can be disabled
    per webhook with `retry: false`. Exceptions: `accepted_invitation` and `invitation_received` are posted only once, without retries.'
note: Custom mode delivers events via HTTPS POST; each request includes headers `X-Linkup-Event-Id`, `X-Linkup-Attempt`, and `X-Linkup-Webhook-Id`
  for deduplication.
docs: https://docs.linkupapi.com/api-reference/v2/webhooks/introduction.md