Trackstar automatically synchronizes data from your connected warehouse systems 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:
Data TypeSync Frequency
InventoryHourly
Inbound ShipmentsHourly
OrdersHourly
ProductsHourly
ReturnsHourly
Shipping MethodsEvery 12 hours
WarehousesEvery 12 hours
Warehouse CustomersEvery 12 hours
Warehouse LocationsEvery 12 hours
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-012T00: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"
}
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 WMS in real time. We respond immediately with the success or error status from the WMS, including any error messages or validation feedback provided by the WMS itself. This ensures transparency and helps with rapid debugging and resolution when issues arise.