{"id":"8633ba06-8241-4938-9f62-994d2b0dc752","task":"Poll QuickBooks Online Change Data Capture (CDC) to sync modified entities to a local database","domain":"developer.intuit.com","steps":["Authenticate via OAuth 2.0 and obtain a valid access token with the required accounting scope","Send a CDC GET request to the QBO v3 company endpoint with a comma-separated list of entity types and a changedSince timestamp in ISO 8601 format","Iterate through each entity collection in the response, processing both updated and deleted records","For deleted records, apply the tombstone pattern using the Id from the DeletedEntities section","Store the response timestamp as the next changedSince value in durable storage before committing local changes","Handle the case where CDC returns a fault indicating the changedSince date is too old by falling back to a full re-sync"],"gotchas":["CDC has a maximum lookback window (roughly 30 days); requests older than this return an error and require a full re-sync rather than incremental update","The changedSince timestamp must be stored atomically with the processed records to avoid duplicate or missed updates on failure","Not all QBO entity types support CDC; verify the supported entity list in the docs before including unsupported types"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/8633ba06-8241-4938-9f62-994d2b0dc752"}