Sync Configuration
Sync Configuration Overview
Sync configuration allows you to customize how Rutter syncs data from your connected platforms. You can control which entities are synced, how far back in time to fetch historical data, and how frequently to perform incremental syncs.
Platform Support
Sync configuration is currently supported for:
- QuickBooks (
QUICKBOOKS
) - Xero (
XERO
) - NetSuite (
NETSUITE
) - Zoho Books (
ZOHOBOOKS
) - Sage Business Cloud (
SAGE_BUSINESS_CLOUD
) - FreshBooks (
FRESHBOOKS
) - QuickBooks Desktop (
QUICKBOOKS_DESKTOP
) - Dynamics 365 (
DYNAMICS365
) - Moneybird (
MONEYBIRD
) - Odoo (
ODOO
) - Stripe (
STRIPE
)
Additional platform support will be added in future releases.
Configuration Levels
Sync configuration can be managed at three levels:
- Organization Level - Organization-wide defaults for all platforms, grouped by platform type (e.g. accounting, commerce, etc.). This is configurable in the Rutter Dashboard under the "Data Sync Configuration" page.
- Platform Level - Organization-wide defaults for a specific platform (e.g., all QuickBooks connections)
- Connection Level - Per-connection overrides
The SyncConfiguration Object
Sync configurations consist of two main components:
Initial Sync
The initial sync configuration defines how historical data is fetched when a connection is first established or when a full refresh is performed.
batches
: Array of entity batches to syncentities
: List of entity types to include in this batch (e.g.,ACCOUNTING_TRANSACTION
,ACCOUNTING_INVOICE
)timeFrameInMonths
: How many months of historical data to fetch for these entities
Incremental Sync
The incremental sync configuration defines how frequently data is refreshed after the initial sync.
entities
: List of entity types to sync incrementallysyncPeriodInMinutes
: How often to perform incremental syncs (60 - 20,160 minutes)
Entity Batching Strategy
You can organize entities into multiple batches based on:
- Time sensitivity: Prioritize the most critical entities for your use case
- Historical requirements: Different entities may need different historical time frames
Properties
initialSync
objectinitialSync
attributesincrementalSync
objectincrementalSync
attributesGet Platform Sync Configuration
Retrieve the sync configuration for a specific platform
Request Parameters
platform
enumpathRequiredPlatform name (case-insensitive). Accepts values like 'quickbooks', 'QUICKBOOKS', etc.
Response Body
1{
2 "initialSync": {
3 "batches": [
4 {
5 "timeFrameInMonths": 12,
6 "entities": [
7 "ACCOUNTING_TRANSACTION"
8 ]
9 }
10 ]
11 },
12 "incrementalSync": {
13 "syncPeriodInMinutes": 120,
14 "entities": [
15 "ACCOUNTING_TRANSACTION"
16 ]
17 }
18}
Create or Overwrite Platform Sync Configuration
Create or overwrite the sync configuration for a specific platform, defining initial sync batches and incremental sync settings.
Request Parameters
platform
enumpathRequiredPlatform name (case-insensitive). Accepts values like 'quickbooks', 'QUICKBOOKS', etc.
Request Body
Sync configuration for a specific platform e.g. Quickbooks
initialSync
objectinitialSync
attributesincrementalSync
objectincrementalSync
attributesResponse Body
1{
2 "initialSync": {
3 "batches": [
4 {
5 "timeFrameInMonths": 12,
6 "entities": [
7 "ACCOUNTING_TRANSACTION"
8 ]
9 }
10 ]
11 },
12 "incrementalSync": {
13 "syncPeriodInMinutes": 120,
14 "entities": [
15 "ACCOUNTING_TRANSACTION"
16 ]
17 }
18}
1{
2 "initialSync": {
3 "batches": [
4 {
5 "timeFrameInMonths": 12,
6 "entities": [
7 "ACCOUNTING_TRANSACTION"
8 ]
9 }
10 ]
11 },
12 "incrementalSync": {
13 "syncPeriodInMinutes": 120,
14 "entities": [
15 "ACCOUNTING_TRANSACTION"
16 ]
17 }
18}
Delete Platform Sync Configuration
Delete the sync configuration for a specific platform, removing all custom sync settings and reverting to organization-level defaults.
Request Parameters
platform
enumpathRequiredPlatform name (case-insensitive). Accepts values like 'quickbooks', 'QUICKBOOKS', etc.
Get Connection Sync Configuration
Retrieve the sync configuration for a specific connection. If the connection does not have a custom sync configuration, a 404 response will be returned.
Request Parameters
id
stringpathRequiredThe Rutter generated unique ID of the object.
Response Body
1{
2 "initialSync": {
3 "batches": [
4 {
5 "timeFrameInMonths": 12,
6 "entities": [
7 "ACCOUNTING_TRANSACTION"
8 ]
9 }
10 ]
11 },
12 "incrementalSync": {
13 "syncPeriodInMinutes": 120,
14 "entities": [
15 "ACCOUNTING_TRANSACTION"
16 ]
17 }
18}
Delete Connection Sync Configuration
Delete the sync configuration for a specific connection. This removes any custom sync settings, and the connection will fall back to using the platform-level or organization-level sync configuration.
Request Parameters
id
stringpathRequiredThe Rutter generated unique ID of the object.
Have questions?
Contact support for personalized guidance.