---
title: "Create Budget"
method: POST
path: "/budget/create"
tags: ["Budget V2 Management"]
---

# Create Budget

`POST /budget/create`

Budget Create

## Request body

- BudgetCreateUpdateRequest
  - `budget_name` string, required — Provide a name for your budget
  - `budget_id` string — Id of Budget to create budget data
  - `status` 'pending' | 'in_progress' | 'completed' | 'expired' | 'draft' — The status of the budget corresponds to its budget ID and can be in one of the following states: pending: This is the state before the budget has been synchronized. in_Progress: This is the state when the budget is currently being synchronized. completed: This is the state when the budget has successfully completed its synchronization.
  - `tenant_id` string — Specify the tenant ID. This is a unique ID and can be retrieved using the List Tenants API.
  - `budget_event_type` 'create' | 'update', required — budget event type.
  - `budget_frequency` string, required — Specify the budget frequency. Example: 'budget frequency':'Daily' Allowed values - Daily,Monthly,Quarterly,Annually
  - `budget_type` string, required — Budget type will Be COST for AWS and Cost for Azure
  - `budget_details` BudgetDetailsModel
    - `is_recurring` boolean, required — give false for non-recurring budget
    - `currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — currency of the cost. Example 'currency':'USD'
    - `from_date` string, required — from date for that rule. Example: 'end_date': '2021-04-01T12:00:00.000Z
    - `to_date` string — to date for that rule. Example: 'end_date': '2021-04-01T12:00:00.000Z
    - `cloud` string[] — The name of the cloud service. for example, AWS.
    - `cloud_account_id` string[] — Specify the cloud account id to view, cloud account id is unique can be obtained from the list cloud account api.
    - `dimension` BudgetDimensionDetailsModel
      - `sys_id` string, required — Dimension ID for the budget. This is a unique ID and can be retrieved using the List Dimensions API.
      - `name` string, required — Dimension name for the budget. This is a unique name and can be retrieved using the List Dimensions API.
      - `values` string[], required — Dimension value for the budget. This is a unique value and can be retrieved using.
      - `grouping_rule_ids` string[], required — List of grouping rule IDs to be associated with the budget. This is a unique ID and can be retrieved using the List Grouping Rules API.
      - `entity` string, required — Entity type for the dimension. This is a unique entity type and can be retrieved.
    - `filters` BudgetCreateFiltersModel
      - `resource_type` FilterIdNameModel[] — resource_type with id name. Id and name can be obtained from /budget/filter_values API
        - `id` string, required — Id of filter key
        - `name` string, required — Id of filter name
      - `tags` object — tag filter values.Format should key nad list of values
  - `metadata` BudgetMetaModel
    - `tracking` BudgetTrackingModel
      - `next_step` integer — next step no
  - `budget_amount` BudgetAmountModel
    - `amount` integer, required — budget amount
    - `type` string — type of budget amount. Allowed values will be auto_increment/auto_suggest/fixed
    - `planned_budget_limit` BudgetLimitModel[] — planned budget_limit for auto_suggest/auto_increment type
      - `amount` integer — budget amount for that period
      - `month` string — month format should be Jun-2015 and for annually 2020
    - `budget_growth` number — Percentage value for auto_increment type only

## Response `200`

Success

- BudgetCreateUpdateResponse
  - `tenant_id` string — tenant id
  - `budget_name` string — created/updated budget name
  - `is_corestack_created` boolean — true if budget created in corestack
  - `is_recurring` boolean — true if recurring budget
  - `budget_id` string, required — Specify the budget ID.This is a unique ID and can be retrieved using the create budget_UI
  - `budget_engine` string — budget engine
  - `budget_frequency` string — Specify the budget frequency. Example: 'budget frequency':'Daily' Allowed values - Daily,Monthly,Quarterly,Annually
  - `budget_type` string — budget type
  - `budget_uri` string, required — budget uri

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)