---
title: "Create budget topup"
method: POST
path: "/v1/businesses/{client_id}/budgets/{budget_id}/topups"
tags: ["Budget Topups"]
---

# Create budget topup

`POST /v1/businesses/{client_id}/budgets/{budget_id}/topups`

## Request

- Base URL: `https://public.letsweel.com`
- URL: `https://public.letsweel.com/v1/businesses/{client_id}/budgets/{budget_id}/topups`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/letsweel/apis/weel-openapi/docs/v1/businesses/:client_id/budgets/:budget_id/topups/post.ts> (a function with typed inputs; its response is checked against the schema)

Increase or decrease the available amount of a budget. Only permitted when `has_member_limits` is `false` for the budget.

## Path parameters

- `client_id` integer, required
- `budget_id` string, required

## Request body

- BudgetTopupCreate
  - `amount` number, required: Positive values increase the available amount, negative values decrease it.
  - `description` string, required: The description of the topup.
  - `auto_approve` boolean: By default, topups require approval before being added to the budget. Set this to `true` to automatically add the topup to the budget.

## Response `200`

OK

- BudgetTopup
  - `id` string: The ID of the topup.
  - `amount` number: Positive values increase the available amount, negative values decrease it.
  - `description` string: The description of the topup.
  - `status` 'APPROVED' | 'CANCELLED' | 'DECLINED' | 'PENDING': The status of the topup.
  - `requested_by` SubUser, nullable
    - `id` integer: The ID of the user.
    - `first_name` string: The first name of the user.
    - `last_name` string: The last name of the user.
    - `name` string: The full name of the user or the display name if the user has set one.
  - `actioned_by` SubUser, nullable
    - `id` integer: The ID of the user.
    - `first_name` string: The first name of the user.
    - `last_name` string: The last name of the user.
    - `name` string: The full name of the user or the display name if the user has set one.
  - `actioned_on` string, date-time: The date and time when the topup was actioned in UTC.
  - `created` string, date-time: The date and time when the topup was created in UTC.
  - `updated` string, date-time: The date and time when the topup was last updated in UTC.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/letsweel/apis/weel-openapi.md) - [All operations](https://skmtc.dev/letsweel/apis/weel-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/letsweel/apis/weel-openapi/revisions/b1e30cdf67f3?raw)