account.disconnected
Fired when a PMS or OTA account is disconnected — by the user, admin, or due to expired credentials.
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.disconnected",
"timestamp": "2026-04-04T18:00:00Z",
"data": {
"provider": "hostaway",
"accountId": "acc_uuid",
"reason": "user_initiated"
}
}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 === 'account.disconnected') {
console.log('Disconnected:', data.provider, 'reason:', data.reason)
// Clean up cached data, notify admin
}Tip: Acknowledge with a 2xx status within 10 seconds. Failed deliveries are retried up to 5 times with exponential backoff.Webhook reliability →
AI