Query Changes
CertifiedGet the entities changed since a date (Change Data Capture)
Query Changes
Get the entities changed since a date (Change Data Capture)
Calls the QuickBooks Change Data Capture endpoint. QuickBooks only keeps about 30 days of changes, so changedSince must be within that window.
type: io.kestra.plugin.quickbooks.query.ChangesExamples
Get changed Invoice and Customer records since a specific date
id: quickbooks_changes
namespace: company.team
tasks:
- id: get_changes
type: io.kestra.plugin.quickbooks.query.Changes
clientId: "{{ secret('QBO_CLIENT_ID') }}"
clientSecret: "{{ secret('QBO_CLIENT_SECRET') }}"
refreshToken: "{{ secret('QBO_REFRESH_TOKEN') }}"
realmId: "{{ secret('QBO_REALM_ID') }}"
entities:
- Invoice
- Customer
changedSince: "2026-01-01T00:00:00Z"
Properties
changedSince *string
Changed since
Only changes after this ISO 8601 date-time are returned, for example 2026-01-01T00: 00: 00Z.
clientId *string
QuickBooks Client ID
The OAuth2 Client ID for your QuickBooks application
clientSecret *string
QuickBooks Client Secret
The OAuth2 Client Secret for your QuickBooks application
entities *array
Entities
The QuickBooks entities to check for changes, for example Invoice or Customer.
realmId *string
QuickBooks Realm ID
The Realm ID (Company ID) for the QuickBooks account. Digits only, checked after rendering.
refreshToken *string
QuickBooks Refresh Token
A valid OAuth2 refresh token. Kestra will automatically rotate and persist it in the KV Store. Note: Token rotation is not cross-worker concurrency safe, and failed KV store writes may result in lost tokens.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150authUrl string
https://oauth.platform.intuit.com/oauth2/v1/tokens/bearerAuthentication URL
The OAuth2 token endpoint. Must be an intuit.com domain.
baseUrl string
https://quickbooks.api.intuit.comBase URL
The Base URL for QuickBooks API. Must be an intuit.com domain. Defaults to production.
minorVersion integerstring
75Minor Version
The minor version of the QuickBooks API to use. Must be 1 or more, checked after rendering.
Outputs
cdcResponse object
CDC response
The parsed JSON response of QuickBooks with the full changed records.
rows object
Changed rows per entity
Maps each requested entity to its changed records. Every record has id, status (Created, Updated or Deleted) and deleted. An entity without changes maps to an empty list.
