General
Server Side SDKs
Core API
curl --request POST \
--url https://api.rootfi.dev/v3/accounting/accounts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"company_id": 123,
"data": [
{
"name": "Rootfi Test Account",
"description": "Rootfi Test Account",
"nominal_code": "123456",
"sub_category": "Test",
"currency_id": "123456",
"parent_account_id": "1234567"
}
]
}
'{
"data": {
"rootfi_id": 157,
"rootfi_deleted_at": null,
"rootfi_created_at": "2024-01-22T05:07:31.465Z",
"rootfi_updated_at": "2024-01-22T05:07:31.000Z",
"rootfi_company_id": 1089,
"platform_id": "123456_1",
"platform_unique_id": "123456",
"name": "Rootfi Test Account",
"description": "Rootfi Test Account",
"nominal_code": "123456",
"current_balance": 0,
"updated_at": "2021-08-10T14:00:00.000Z",
"status": "active",
"category": "ASSET",
"sub_category": "Test",
"currency_id": "123456",
"parent_account_id": "1234567"
}
}Create Account
Create an account.
curl --request POST \
--url https://api.rootfi.dev/v3/accounting/accounts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"company_id": 123,
"data": [
{
"name": "Rootfi Test Account",
"description": "Rootfi Test Account",
"nominal_code": "123456",
"sub_category": "Test",
"currency_id": "123456",
"parent_account_id": "1234567"
}
]
}
'{
"data": {
"rootfi_id": 157,
"rootfi_deleted_at": null,
"rootfi_created_at": "2024-01-22T05:07:31.465Z",
"rootfi_updated_at": "2024-01-22T05:07:31.000Z",
"rootfi_company_id": 1089,
"platform_id": "123456_1",
"platform_unique_id": "123456",
"name": "Rootfi Test Account",
"description": "Rootfi Test Account",
"nominal_code": "123456",
"current_balance": 0,
"updated_at": "2021-08-10T14:00:00.000Z",
"status": "active",
"category": "ASSET",
"sub_category": "Test",
"currency_id": "123456",
"parent_account_id": "1234567"
}
}Additional Required Fields
To successfully create an account, certain fields must be included in the raw_data object of the request body. The required fields are as follows:| Integration | Field | Description |
|---|---|---|
| MS_DYNAMICS_365_FO | ChartOfAccounts | The chart of accounts to which the account belongs. |
| MYOB_BUSINESS | tax_id | The tax ID associated to the account. |
| SAGE_ZA_CLOUD_ACCOUNTING | sub_category_id | The sub-category ID associated to the account. |
Authorizations
Body
The ID of the company in the accounting platform
The data of the accounts endpoint
Show child attributes
Show child attributes
Name of the account
Description of the account
The nominal code of the account
The current balance of the account
The date the account was last updated
The status of the account
The category of the account
ASSET, EXPENSE, LIABILITY, EQUITY, INCOME, BANK, UNKNOWN The sub category of the account
The currency id of the account
The parent account id of the account
Run the request asynchronously
Response
The data of the accounts endpoint
Show child attributes
Show child attributes
The unique ID we assign for that data's information
157
The date at which RootFi first synced this data
"2024-01-22T05:07:31.465Z"
The latest date at which RootFi updated this data
"2024-01-22T05:07:31.000Z"
The ID of the company in the accounting platform
1089
An unique custom RootFi ID made from platform's unique_id.
"123456"
The date at which the data was deleted in the accounting platform
The ID of the data in the accounting platform.
A JSON containing fields that you can directly get from the accounting platform.
The hash of the data
Name of the account
Description of the account
The nominal code of the account
The current balance of the account
The date the account was last updated
The status of the account
The category of the account
ASSET, EXPENSE, LIABILITY, EQUITY, INCOME, BANK, UNKNOWN The sub category of the account
The currency id of the account
The parent account id of the account
The parent account of the account.
Show child attributes
Show child attributes
The unique ID we assign for that data's information
157
The date at which RootFi first synced this data
"2024-01-22T05:07:31.465Z"
The latest date at which RootFi updated this data
"2024-01-22T05:07:31.000Z"
The ID of the company in the accounting platform
1089
An unique custom RootFi ID made from platform's unique_id.
"123456"
The date at which the data was deleted in the accounting platform
The ID of the data in the accounting platform.
A JSON containing fields that you can directly get from the accounting platform.
The hash of the data
Name of the account
Description of the account
The nominal code of the account
The current balance of the account
The date the account was last updated
The status of the account
The category of the account
ASSET, EXPENSE, LIABILITY, EQUITY, INCOME, BANK, UNKNOWN The sub category of the account
The currency id of the account
The parent account id of the account
The currency of the account.
Show child attributes
Show child attributes
The unique ID we assign for that data's information
157
The date at which RootFi first synced this data
"2024-01-22T05:07:31.465Z"
The latest date at which RootFi updated this data
"2024-01-22T05:07:31.000Z"
The ID of the company in the accounting platform
1089
An unique custom RootFi ID made from platform's unique_id.
"123456"
The date at which the data was deleted in the accounting platform
The ID of the data in the accounting platform.
A JSON containing fields that you can directly get from the accounting platform.
The hash of the data
The name of the currency
The currency code.
The symbol that represents the currency. Not applicable for many currencies.
Whether the currency is the base currency for the company.
The exchange rate for the currency.
The last ISO 8601 timestamp that the data was updated at.
The sync id of the request