Create a sync
Creates a sync from accounts to a destination and queues its first run. The destination must be active (have a target); YNAB needs account_mappings; brokerage accounts need a Sheets destination. One sync per destination.
Authorizations
Authorization: Bearer rbk_live_...
The API release your integration is built against, e.g. 2026-10-01.wattle. Required on every request.
Body
"dest_3Fg5Hj7kLm9nPq1rSt3uVw"
1Default transactions
transactions, accounts, holdings, trades 80Sheets only: per_account writes each account to its own tab (created for you when account_mappings is omitted)
bulk, per_account Required for YNAB (budget account per bank account); optional for Sheets per_account
1Queue the first run immediately (default true)
Up to 50 string pairs. Set a key to null to unset it.
Response
The created sync (latest_run is the queued first run)
"sync_8Pq2Rs4tUv6wXy8zAb1cDe"
sync transactions, accounts, holdings, trades idle, running, attention include[]=latest_run
"2026-08-21T09:30:00.000Z"
Up to 50 string pairs. Set a key to null in an update to unset it.
"2026-08-21T09:30:00.000Z"
"2026-08-21T09:30:00.000Z"