Sign in
Transfers

Create transfer transaction

Use the Create transfer endpoint to create or update a transfer transaction in the accounting software for a given company's connection.

Transfers record the movement of money between two bank accounts, or between a bank account and a nominal account. Use them to represent actions such as topping up a debit card account or a balance transfer to another credit card.

The from.amount and to.amount fields are in the native currency of the account.

Supported Integrations

IntegrationCreate transferUpdate transfer
DynamicsNoNo
FreeAgentYesYes
NetSuiteNoNo
QuickBooks DesktopYesNo
QuickBooks OnlineYesYes
Sage IntacctNoNo
XeroYesNo
Zoho BooksNoNo
put/companies/{companyId}/sync/expenses/transfer-transactions/{transactionId}

Request body

descriptionstring

Any private, company notes about the transaction.

datestring required

In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:

2020-10-08T22:40:50Z
2021-01-01T00:00:00

When syncing data that contains DateTime fields from Codat, make sure you support the following cases when reading time information:

  • Coordinated Universal Time (UTC): 2021-11-15T06:00:00Z
  • Unqualified local time: 2021-11-15T01:00:00
  • UTC time offsets: 2021-11-15T01:00:00-05:00

Time zones

Not all dates from Codat will contain information about time zones.
Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced.

Example request

{
  "description": "Transfer from bank account Y to bank account Z",
  "date": "2022-10-23T00:00:00Z"
}

Response

OK

syncIdstring uuid

Unique id of sync created

Example response

{
  "syncId": "cd937d46-8e41-43a9-9477-a79158ffd98a"
}