---
title: "POST /data/sync"
method: POST
path: "/data/sync"
tags: ["Data"]
---

# POST /data/sync

`POST /data/sync`

## Request

- Base URL: `https://api.railz.ai`
- URL: `https://api.railz.ai/data/sync`
- Auth: HTTP bearer

Initiates the synchronisation for a specific data type.

## Request body

- DataSyncDto
  - `businessName` string, required
  - `serviceName` 'freshbooks' | 'quickbooks' | 'quickbooksDesktop' | 'xero' | 'oracleNetsuite' | 'sageBusinessCloud' | 'sageIntacct' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'shopify' | 'square' | 'plaid' | 'myob' | 'zohoBooks' | 'byod', required
  - `dataType` 'accountingTransactions' | 'accounts' | 'agedPayable' | 'agedReceivable' | 'attachments' | 'balanceSheets' | 'bankingReconciliation' | 'bankTransactions' | 'bankAccounts' | 'bankTransfers' | 'billCreditNotes' | 'billPayments' | 'bills' | 'budgets' | 'businessInfo' | 'businessValuations' | 'cashflowStatements' | 'creditScore' | 'customers' | 'deposits' | 'estimates' | 'financialBenchmarking' | 'financialForecasts' | 'financialRatios' | 'fraudRiskMetrics' | 'incomeStatements' | 'inventory' | 'invoiceCreditNotes' | 'invoicePayments' | 'invoices' | 'journalEntries' | 'journals' | 'probabilityOfDefault' | 'purchaseOrders' | 'refunds' | 'taxBenchmarking' | 'taxRates' | 'taxAuthority' | 'trackingCategories' | 'trialBalances' | 'vendors' | 'paymentMethods' | 'portfolioMetrics' | 'expenses' | 'contacts' | 'vendorBankAccounts' | 'customerBankAccounts' | 'billPaymentRequests' | 'payrollTransactions' | 'transactions' | 'products' | 'orders' | 'disputes' | 'bankAccounts' | 'bankTransactions' | 'bankAssets', required
  - `fullSync` boolean

## Response `200`

- DataSyncResponseDto
  - `connectionId` string, required
  - `businessName` string, required
  - `serviceName` 'quickbooks' | 'xero' | 'freshbooks' | 'quickbooksDesktop' | 'sageIntacct' | 'sageBusinessCloud' | 'oracleNetsuite' | 'dynamicsBusinessCentral' | 'dynamics365Finance' | 'wave' | 'zohoBooks' | 'myob', required
  - `dataType` string, required
  - `requestedOn` string, date-time, required

## Other responses

- `400`: Bad Request Error - Thrown if fields sent via query does not follow specifications
- `401`: Unauthorized - Not logged in or log in expired
- `403`: Forbidden - Not enough permission
- `500`: Server Error

## Changes

- **2026-08-10** `5cdfae3fa1fa`: 1 breaking, 12 warning, 19 info
  - removed the enum value `employees` of the request property `dataType`
  - added the new `dynamics365Finance` enum value to the `serviceName` response property for the response status `200`
  - added the new `dynamicsBusinessCentral` enum value to the `serviceName` response property for the response status `200`
  - added the new `freshbooks` enum value to the `serviceName` response property for the response status `200`
  - …28 more

[Operation history](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/changes/data/sync/post.md)

---

[API](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api.md) - [All operations](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/railz/apis/fis-accounting-data-as-a-service-api/revisions/1383b9a47ac9?raw)