v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-01-29166197289.1 KB
budgets

Create a budget

Create a budget. This endpoint accepts the optional MX-Skip-Webhook header and skip_webhook parameter. You cannot create a duplicate budget. For example, if you attempt to create a budget for "Gas", but that budget already exist, the request will fail. You can retrieve a list of all existing categories by using the List Categories endpoint.

post/users/{user_guid}/budgets

Response

OK

Example response

{
  "budget": {
    "amount": 153,
    "category_guid": "CAT-bd56d35a-a9a7-6e10-66c1-5b9cc1b6c81a",
    "created_at": "2018-10-18T19:51:26+00:00",
    "guid": "BGT-6ca0e3ef-c65e-4655-8b5a-275a3c19c21d",
    "is_exceeded": true,
    "is_off_track": true,
    "metadata": "some metadata",
    "name": "Food & Dining",
    "percent_spent": 1276.34,
    "projected_spending": 3562.4,
    "revision": 561,
    "transaction_total": 1952.8,
    "updated_at": "2022-06-14T21:17:11+00:00",
    "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
  }
}