Sync settings

On the Sync Settings page in the Codat Portal, you can override the default sync settings, and specify your own fetch order and frequency for datasets. You can also choose whether a dataset is automatically synced when a company is linked for the first time.

Override the default sync settings

To customize your sync settings:

  1. Sign in to the Codat Portal.
  2. In the navigation bar, select Account > Sync settings.
    The Sync Settings page is displayed.
  3. Customize settings for the data types you're interested in and save your changes. Read the sections below for more information about each setting.

Change the fetch order of data types

The order of the data types on the Sync settings page is the order in which they are queued to be synchronized. You can change the order using the arrows on the left side of the page.

Where possible, Codat fetches datasets concurrently, but some accounting platforms limit the number of requests that can be made each minute. These limits mean that a data type may remain queued while waiting for the limit to refresh so you may choose to prioritize the data types you need to be synchronized first.

Use "Fetch on first link"

By default, Fetch on first link is on for most data types.

When Fetch on first link is on for a data type:

  • The data type is automatically queued for synchronization when a company is first linked, provided that the data type is available in the company's accounting platform.
  • The data type is queued for synchronization when clicking the Queue Sync button for a company in the Codat Portal.
  • The data type is queued for synchronization when you make a request to POST /companies/{companyId}/data/queue/{dataType} with all as the datatype.

When Fetch on first link is turned off for a data type:

  • The data type is not automatically queued for synchronisation when a company is first linked.
  • You can still queue a sync for this individual data type using the POST /companies/{companyId}/data/queue/{dataType} endpoint. This might be useful for testing, or if you only need infrequent access to a dataset.


If you have enabled hourly syncs for a data type that does not have Fetch on first link enabled, the initial queue of the data type will occur within around an hour of first linking the company. This also applies to daily, weekly and monthly sync frequencies.

For more information about how to sync data sets on demand, see Synchronizing your data.

Queue a sync from the Codat Portal

To manually arrange your data to be synchronized:

  1. In the navigation bar of the Codat Portal, select Companies.
  2. Click on a company
  3. Click Queue sync.

Choose a sync frequency

Setting the Sync frequency for a data type to anything other than None automatically syncs the data type on a daily, weekly, or monthly basis.

By default, Sync frequency is set to None.

Did this page help you?