Create a new or update existing Budgets entries. | Gappify

Create a new or update existing Budgets entries with the provided data.

Required Fields Summary

Field	Type	Description
`source_system_id`	string	Unique identifier of the budget in the ERP system
`subsidiary_currency_id`	string	Subsidiary currency id of the budget line
`subsidiary_amount`	double	Amount of the budget in the subsidiary’s base currency
`period`	date	Budget applicable period. ⚠️ Required format: `yyyy-mm-01`

Create a new or update existing Budgets entries with the provided data. ## Required Fields Summary | Field | Type | Description | |-------|------|-------------| | `source_system_id` | string | Unique identifier of the budget in the ERP system | | `subsidiary_currency_id` | string | Subsidiary currency id of the budget line | | `subsidiary_amount` | double | Amount of the budget in the subsidiary's base currency | | `period` | date | Budget applicable period. <br/>⚠️ **Required format:** `yyyy-mm-01` |

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a list of objects.

source_system_idstringRequired

Unique identifier of the invoice in the erp system. This value will be used to match source data and perform upserts.

subsidiary_currency_idstringRequired

Subsidiary currency id of the budget line. Should match the name in the currency list of source_coas.

subsidiary_amountdoubleRequired

Amount of the budget in the subsidiarys base currency.

perioddateRequired

Budget applicable period.
Format: yyyy-mm-01 (e.g., 2026-03-01).

vendor_idstringOptional

Id of the Vendor/Supplier. This value should match the source_vendors->g_source_system_id which will be used to send back as part of JE to ERP.

subsidiary_idstringOptional

Subsidiary id linked to the budget line. This value should match the g_source_system_id in source_coas.

department_idstringOptional

Department id linked to the budget line. This value should match the g_source_system_id in source_coas.

glaccount_numberstringOptional

GLAccount number

glaccount_idstringOptional

GLAccount id linked to the budget line. This value should match the g_source_system_id in source_coas.

Response

This endpoint returns an object.

request_idUUID

Unique identifier for the request

status"IN_PROGRESS"

Status of the request

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error