---
title: "Posts an allowance for a folio"
method: POST
path: "/finance/v0-nsfw/folio-actions/{folioId}/allowances"
tags: ["FolioActions"]
---

# Posts an allowance for a folio

`POST /finance/v0-nsfw/folio-actions/{folioId}/allowances`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/finance/v0-nsfw/folio-actions/{folioId}/allowances`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `allowances.post`, `folios.manage`, `admin`

Allowance value posted must not exceed sum of charges minus existing allowances<br>You must have at least one of these scopes: 'allowances.post, folios.manage'.<br>For fine-grained clients, you must have this permission: 'core.folios.post_folio_allowance'.

## Path parameters

- `folioId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- CreateAllowanceForFolioModel
  - `serviceType` 'Other' | 'Accommodation' | 'FoodAndBeverages' | 'CityTax' | 'SecondCityTax', required: The service type, used by accounting to determine the correct revenue account
  - `vatType` 'Null' | 'VeryReduced' | 'Reduced' | 'Normal' | 'Without' | 'Special' | 'Special1' | 'Special2' | 'ReducedCovid19' | 'NormalCovid19' | 'Mixed', required: The VAT type, used by accounting to determine the correct vat amount and account
  - `subAccountId` string, nullable: ID of the custom sub-account to post the allowance to, used by accounting to determine the correct revenue account
  - `reason` string, required: Reason why this allowance is posted
  - `amount` MonetaryValueModel, required
    - `amount` number, double, required
    - `currency` string, required
  - `businessDate` string, date, nullable: The business date of the allowance. Defaults to the current date. In some cases you might want to post the allowances to the previous business date, this is only possible until 6 AM of the current day.

## Response `200`

Success.

- CreatedSubResourceIdModel
  - `id` string, required

## Other responses

- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `415`: Unsupported media type.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/revisions/72cbd31f02f4?raw)