---
title: "POST Budget"
method: POST
path: "/sales/budget?access_token=xxxxx"
---

# POST Budget

`POST /sales/budget?access_token=xxxxx`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/sales/budget?access_token=xxxxx`
- Auth: API key in query parameter `access_token`

/budget
Permission Level: 4

## Request body `application/x-www-form-urlencoded`

- object
  - `start_date` string, date: Start date of the budget that we want to add
  - `end_date` string, date: End date of the budget that we want to add
  - `hours` integer: Hours
  - `Dollars` integer: Amount of dollars for the given hours
  - `Location` integer: Location ID for which we want to create a budget
  - `Position` integer: Position ID for which we want to create a budget

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` string
    - `store` string
    - `start_date` object
      - `id` integer
      - `timestamp` integer
      - `month` integer
      - `day` integer
      - `year` integer
      - `week` integer
      - `dayid` integer
      - `weekday` string
      - `mname` string
      - `formatted` string
    - `end_date` object
      - `id` integer
      - `timestamp` integer
      - `month` integer
      - `day` integer
      - `year` integer
      - `week` integer
      - `dayid` integer
      - `weekday` string
      - `mname` string
      - `formatted` string
    - `location` string
    - `hours` string
    - `dollars` string
    - `position` string
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/sales/budget%3Faccess_token=xxxxx/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
