Docs/Webhooks/Account

account.calendar_access_changed

Vrbo says another tool (such as the host's PMS) started or stopped managing a connected Vrbo account's calendar.

When it fires

Repull asks Vrbo when the account connects and once a day. The event is sent when the answer changes. While calendar.managedBy is integrated_software, Vrbo refuses price and availability changes from anyone else: Repull keeps bookings, inquiries, messages and reviews working, turns calendar sync off for every unit of the account, and refuses calendarSync: true with 409 calendar_managed_elsewhere. When it goes back to null, nothing is switched on by itself.

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.calendar_access_changed",
  "eventId": "3f1c9a2e-8b7d-4c6a-9e0f-1a2b3c4d5e6f",
  "apiVersion": "2026-04",
  "timestamp": "2026-05-01T12:34:56.000Z",
  "data": {
    "workspaceId": 1204,
    "provider": "vrbo",
    "accountId": "1295468",
    "connectionId": 909,
    "calendar": {
      "managedBy": "integrated_software",
      "detectedAt": "2026-11-16T19:06:56.653Z",
      "checkedAt": "2026-11-16T19:06:56.653Z",
      "docsUrl": "https://repull.dev/docs/channels/vrbo/calendar-managed-elsewhere"
    },
    "changedAt": "2026-11-16T19:06:56.653Z"
  }
}

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.calendar_access_changed') {
  const { accountId, calendar } = event.data
  if (calendar.managedBy) {
    // Prices and availability for this Vrbo account are managed elsewhere: hide your calendar controls.
    await accounts.setVrboCalendarSync(accountId, false)
  } else {
    // Free again. Turn calendar sync on per unit when the user asks:
    // POST /v1/connections/vrbo:{accountId}/mappings with calendarSync: true
    notify('Vrbo calendar sync can be turned on again')
  }
}

Common patterns

  • Show "Calendar managed by your PMS" next to the Vrbo account and disable calendar settings while calendar.managedBy is set.
  • Read the current state any time from calendar on GET /v1/connect/vrbo-login.

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

AI