---
title: "Creates an invoice for one specific folio."
method: POST
path: "/finance/v1/invoices"
tags: ["Invoice"]
---

# Creates an invoice for one specific folio.

`POST /finance/v1/invoices`

## 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/v1/invoices`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `invoices.create`, `invoices.manage`, `admin`

Creates an invoice for one specific folio. The invoice can only be created once.
The debitor needs to have name, city, postal code and country code, as these are required for invoices.
If the folio is not fully paid, this will check out the reservation on AR and create an invoice with outstanding payments.<br>You must have at least one of these scopes: 'invoices.create, invoices.manage'.<br>For fine-grained clients, you must have this permission: 'core.invoices.create'.

## Headers

- `Idempotency-Key` string

## Request body

- CreateInvoiceRequest
  - `folioId` string, required: The ID of the folio for which the invoice should be created.
  - `languageCode` string, required: The language in which the invoice should be produced.

## Response `201`

The invoice was created successfully.

- InvoiceCreatedModel
  - `id` string, required: The invoice id

## 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.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-finance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-finance-api/revisions/6f1d524c1ea7?raw)