Skip to main content
Trackstar automatically synchronizes data from your connected integrations at predefined intervals. This ensures that your application consistently accesses the most up-to-date information without the need to manage the complexities of each system’s update patterns.

​
Default Sync Frequencies

Different data types are synchronized at varying intervals to balance data freshness and system performance. Below is a breakdown of the default synchronization frequencies:
APIData TypeSync Frequency
WMSInventoryHourly
WMSInbound ShipmentsHourly
WMSOrdersHourly
WMSProductsHourly
WMSReturnsHourly
WMSShipping MethodsEvery 12 hours
WMSWarehousesEvery 12 hours
WMSWarehouse CustomersEvery 12 hours
WMSWarehouse LocationsEvery 12 hours
CartOrdersHourly
CartProductsHourly
CartWarehousesEvery 12 hours
CarrierInvoice Line ItemsDaily
Note: These frequencies are default settings and can be customized per connection.

​
Initial Sync Behavior

Upon establishing a new connection, Trackstar performs an initial synchronization that retrieves data from the past 30 days by default. This historical sync ensures that your system starts with a comprehensive dataset. To adjust the historical lookback window, navigate to your dashboard’s Sync Settings. When each data type (e.g. inventory, orders) has finished syncing for the first time, we will send a connection.historical-sync-completed event. This indicates data is now available for that data type from our API. Example: 
{
  "connection_id": "connection_id",
  "data": {
    "newest_data_date": "2025-05-01T00:00:00Z",
    "oldest_data_date": "2025-01-01T00:00:00Z",
    "resource": "orders"
  },
  "event_type": "connection.historical-sync-completed",
  "integration_name": "integration_name",
  "integration_type": "wms"
}
You can also check the sync status of a connection programmatically by calling GET /connections/{id}. More information on our webhooks can be found in the webhooks documentation.

​
Customizing Sync Frequencies

Sync frequencies can be tailored on a per-connection basis to meet specific business requirements. If you need to modify the synchronization interval for a particular data type or connection, please contact our support team for assistance.

​
Triggering a Sync

Beyond the scheduled synchronizations, you have the option to manually trigger a sync:
  • Via the Dashboard: Go to the Connections Page, click on the connection you want to sync, press the sync button for the desired data type.
  • Via the API: Utilize the POST Sync Connection endpoint to initiate a sync programmatically. This functionality is particularly useful when immediate data updates are required outside the regular sync schedule.
Note: Manually triggering a sync starts the process right away, but it may take a few minutes for new data to appear as the sync completes in the background.

​
Real-Time Writes (POSTs and PUTs)

When you perform a write operation (such as creating or updating a resource via POST or PUT), Trackstar forwards that request directly to the underlying integration in real time. We respond immediately with the success or error status from the integration, including any error messages or validation feedback provided by the integration itself. This ensures transparency and helps with rapid debugging and resolution when issues arise.