---
title: "Creates a pro-forma invoice for one specific folio."
method: POST
path: "/finance/v0-nsfw/invoices/pro-forma"
tags: ["Invoice"]
---

# Creates a pro-forma invoice for one specific folio.

`POST /finance/v0-nsfw/invoices/pro-forma`

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

Creates a pro-forma invoice for one specific folio.<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

- CreateProformaInvoicePdfRequest
  - `folioId` string, required: The ID of the folio for which the pro-forma invoice should be created.
  - `languageCode` string, required: The language in which the pro-forma invoice should be produced.
  - `chargeIds` string[], required: The filter for charges
  - `paymentIds` string[], nullable: The filter for payments

## Response `201`

The advance 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-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)