Docs/Webhooks/Account

account.notifications_missing

A connected Vrbo account had new guest messages, and Vrbo's notification email for them never reached the account's notification address.

When it fires

Sent once when notifications.state on GET /v1/connect/vrbo-login becomes missing: the host has not added the notification address on Vrbo, or turned its notifications off. Messages still arrive, but on the slower scheduled check instead of within about a minute.

Payload

Every delivery uses the same outer envelope (event, eventId, apiVersion, timestamp, data). Dedupe on eventId — it stays stable across retries and replays, while the X-Repull-Delivery-Id header changes on every attempt.

{
  "event": "account.notifications_missing",
  "eventId": "3f1c9a2e-8b7d-4c6a-9e0f-1a2b3c4d5e6f",
  "apiVersion": "2026-04",
  "timestamp": "2026-05-01T12:34:56.000Z",
  "data": {
    "workspaceId": 1234,
    "provider": "vrbo",
    "accountId": "98765432",
    "connectionId": 321,
    "notifications": {
      "state": "missing",
      "lastReceivedAt": "2026-11-02T14:10:05.000Z",
      "address": "in+vrbo-1234-321@repull.dev"
    },
    "detectedAt": "2026-11-17T16:40:00.000Z",
    "docsUrl": "https://repull.dev/docs/channels/vrbo/notifications"
  }
}

Verifying signatures

Every delivery includes a timestamped X-Repull-Signature header of the form t=<unix_ts>,v1=<hex>, where v1 is HMAC-SHA256(signing_secret, `${t}.${raw_body}`). Verify it before processing — see Verify Signatures for full Node.js and Python examples.

Use the raw body

Sign the raw request body exactly as received, not a re-stringified JSON object. Re-serialisation can reorder keys or change whitespace and break the signature.

Example handler

if (event.event === 'account.notifications_missing') {
  const { accountId, notifications } = event.data
  // Ask the host to add the address on Vrbo as a secondary email,
  // with message and reservation notifications on.
  await banners.show(accountId, {
    title: 'Vrbo notifications are not arriving',
    address: notifications.address,
  })
}

Common patterns

  • Show the address with a copy button and the three steps from the notification address page.
  • Clear the banner when notifications.state on GET /v1/connect/vrbo-login is active again.

Tip: Acknowledge with a 2xx status within 10 seconds. Failed deliveries are retried 7 times over 24 hours, with backoff.Webhook reliability →

AI