Ctrl K

Create a budget

Published Oct 17, 2025

Creates a new budget. The API does not compute amounts for calculated budgets, so an `amount` must be provided when creating a budget-detail. Permissions and other requirements SubscriptionGeneral Ledger User typeBusiness User PermissionsAdd Budgets

Script sage_intacct Verified

Use in Windmill

The script

Submitted by hugo697 Bun

Verified 235 days ago

All edits

Permalink

//native
type SageIntacct = {
	token: string
}
/**
 * Create a budget
 * Creates a new budget. The API does not compute amounts for calculated budgets, so an `amount` must be provided when creating a budget-detail.


Permissions and other requirements

SubscriptionGeneral Ledger
User typeBusiness User
PermissionsAdd Budgets




 */
export async function main(
	auth: SageIntacct,
	body: {
		key?: string
		id?: string
		description?: string
		isDefault?: false | true
		submitterName?: string
		status?: 'active' | 'inactive'
		consolidateAmounts?: false | true
		currency?: string
		postProjectEstimate?: false | true
		postProjectContract?: false | true
		audit?: {
			createdDateTime?: string
			modifiedDateTime?: string
			createdBy?: string
			modifiedBy?: string
		} & { createdBy?: string; modifiedBy?: string }
		entity?: { key?: string; id?: string; name?: string; href?: string }
		href?: string
		lines?: {
			key?: string
			id?: string
			budget?: { key?: string; id?: string; href?: string }
			glAccount?: {
				key?: string
				id?: string
				name?: string
				href?: string
			} & { key?: string; id?: string; name?: string; href?: string }
			dimensions?: {
				location?: { key?: string; id?: string; name?: string; href?: string }
				department?: {
					key?: string
					id?: string
					name?: string
					href?: string
				}
				employee?: { key?: string; id?: string; name?: string; href?: string }
				project?: { key?: string; id?: string; name?: string; href?: string }
				customer?: { key?: string; id?: string; name?: string; href?: string }
				vendor?: { key?: string; id?: string; name?: string; href?: string }
				item?: { key?: string; id?: string; name?: string; href?: string }
				warehouse?: { key?: string; id?: string; name?: string; href?: string }
				class?: { key?: string; id?: string; name?: string; href?: string }
				task?: { id?: string; key?: string; name?: string; href?: string }
				costType?: { id?: string; key?: string; name?: string; href?: string }
				asset?: { id?: string; key?: string; name?: string; href?: string }
				contract?: { id?: string; key?: string; name?: string; href?: string }
				affiliateEntity?: {
					key?: string
					id?: string
					href?: string
					name?: string
				}
			} & {
				location?: { key?: string; id?: string; name?: string; href?: string }
				department?: {
					key?: string
					id?: string
					name?: string
					href?: string
				}
			}
			reportingPeriod?: { key?: string; id?: string; href?: string }
			notes?: string
			budgetGrowth?: {
				basedOn?: 'budget' | 'actual' | 'employeeCount'
				growBy?: string
				perPeriod?: 'actual' | 'percentage'
			}
			amount?: string
			currency?: {
				exchangeRateDate?: string
				exchangeRateTypeId?: string
				exchangeRate?: number
				baseCurrency?: string
				txnCurrency?: string
			}
			audit?: {
				createdDateTime?: string
				modifiedDateTime?: string
				createdBy?: string
				modifiedBy?: string
			}
		}[]
	} & { lines?: {}[] }
) {
	const url = new URL(`https://api.intacct.com/ia/api/v1/objects/general-ledger/budget`)

	const response = await fetch(url, {
		method: 'POST',
		headers: {
			'Content-Type': 'application/json',
			Authorization: 'Bearer ' + auth.token
		},
		body: JSON.stringify(body)
	})
	if (!response.ok) {
		const text = await response.text()
		throw new Error(`${response.status} ${text}`)
	}
	return await response.json()
}


`1`	`//native`
`2`	`type SageIntacct = {`
`3`	`token: string`
`4`	`}`
`5`	`/**`
`6`	`* Create a budget`
`7`	* Creates a new budget. The API does not compute amounts for calculated budgets, so an `amount` must be provided when creating a budget-detail.
`8`
`9`
`10`	`Permissions and other requirements`
`11`
`12`	`SubscriptionGeneral Ledger`
`13`	`User typeBusiness User`
`14`	`PermissionsAdd Budgets`
`15`
`16`
`17`
`18`
`19`	`*/`
`20`	`export async function main(`
`21`	`auth: SageIntacct,`
`22`	`body: {`
`23`	`key?: string`
`24`	`id?: string`
`25`	`description?: string`
`26`	`isDefault?: false \| true`
`27`	`submitterName?: string`
`28`	`status?: 'active' \| 'inactive'`
`29`	`consolidateAmounts?: false \| true`
`30`	`currency?: string`
`31`	`postProjectEstimate?: false \| true`
`32`	`postProjectContract?: false \| true`
`33`	`audit?: {`
`34`	`createdDateTime?: string`
`35`	`modifiedDateTime?: string`
`36`	`createdBy?: string`
`37`	`modifiedBy?: string`
`38`	`} & { createdBy?: string; modifiedBy?: string }`
`39`	`entity?: { key?: string; id?: string; name?: string; href?: string }`
`40`	`href?: string`
`41`	`lines?: {`
`42`	`key?: string`
`43`	`id?: string`
`44`	`budget?: { key?: string; id?: string; href?: string }`
`45`	`glAccount?: {`
`46`	`key?: string`
`47`	`id?: string`
`48`	`name?: string`
`49`	`href?: string`
`50`	`} & { key?: string; id?: string; name?: string; href?: string }`
`51`	`dimensions?: {`
`52`	`location?: { key?: string; id?: string; name?: string; href?: string }`
`53`	`department?: {`
`54`	`key?: string`
`55`	`id?: string`
`56`	`name?: string`
`57`	`href?: string`
`58`	`}`
`59`	`employee?: { key?: string; id?: string; name?: string; href?: string }`
`60`	`project?: { key?: string; id?: string; name?: string; href?: string }`
`61`	`customer?: { key?: string; id?: string; name?: string; href?: string }`
`62`	`vendor?: { key?: string; id?: string; name?: string; href?: string }`
`63`	`item?: { key?: string; id?: string; name?: string; href?: string }`
`64`	`warehouse?: { key?: string; id?: string; name?: string; href?: string }`
`65`	`class?: { key?: string; id?: string; name?: string; href?: string }`
`66`	`task?: { id?: string; key?: string; name?: string; href?: string }`
`67`	`costType?: { id?: string; key?: string; name?: string; href?: string }`
`68`	`asset?: { id?: string; key?: string; name?: string; href?: string }`
`69`	`contract?: { id?: string; key?: string; name?: string; href?: string }`
`70`	`affiliateEntity?: {`
`71`	`key?: string`
`72`	`id?: string`
`73`	`href?: string`
`74`	`name?: string`
`75`	`}`
`76`	`} & {`
`77`	`location?: { key?: string; id?: string; name?: string; href?: string }`
`78`	`department?: {`
`79`	`key?: string`
`80`	`id?: string`
`81`	`name?: string`
`82`	`href?: string`
`83`	`}`
`84`	`}`
`85`	`reportingPeriod?: { key?: string; id?: string; href?: string }`
`86`	`notes?: string`
`87`	`budgetGrowth?: {`
`88`	`basedOn?: 'budget' \| 'actual' \| 'employeeCount'`
`89`	`growBy?: string`
`90`	`perPeriod?: 'actual' \| 'percentage'`
`91`	`}`
`92`	`amount?: string`
`93`	`currency?: {`
`94`	`exchangeRateDate?: string`
`95`	`exchangeRateTypeId?: string`
`96`	`exchangeRate?: number`
`97`	`baseCurrency?: string`
`98`	`txnCurrency?: string`
`99`	`}`
`100`	`audit?: {`
`101`	`createdDateTime?: string`
`102`	`modifiedDateTime?: string`
`103`	`createdBy?: string`
`104`	`modifiedBy?: string`
`105`	`}`
`106`	`}[]`
`107`	`} & { lines?: {}[] }`
`108`	`) {`
`109`	const url = new URL(`https://api.intacct.com/ia/api/v1/objects/general-ledger/budget`)
`110`
`111`	`const response = await fetch(url, {`
`112`	`method: 'POST',`
`113`	`headers: {`
`114`	`'Content-Type': 'application/json',`
`115`	`Authorization: 'Bearer ' + auth.token`
`116`	`},`
`117`	`body: JSON.stringify(body)`
`118`	`})`
`119`	`if (!response.ok) {`
`120`	`const text = await response.text()`
`121`	throw new Error(`${response.status} ${text}`)
`122`	`}`
`123`	`return await response.json()`
`124`	`}`
`125`