---
title: "Create additional folios for a reservation, for a booking, or new external folios."
method: POST
path: "/finance/v0-nsfw/folios"
tags: ["Folio"]
---

# Create additional folios for a reservation, for a booking, or new external folios.

`POST /finance/v0-nsfw/folios`

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

Use this call to create a new folio.<br>You must have at least one of these scopes: 'reservations.create, reservations.manage, folios.manage'.<br>For fine-grained clients, you must have this permission: 'core.folios.create'.

## Headers

- `Idempotency-Key` string

## Request body

- CreateFolioModel
  - `reservationId` string, nullable: The ID of the reservation for which a guest folio should be created
  - `bookingId` string, nullable: The ID of the booking for which a booking folio should be created
  - `companyId` string, nullable: The ID of the company for which a folio should be created
  - `debitor` FolioDebitorModel, required
    - `type` 'Booker' | 'PrimaryGuest' | 'Company' | 'AdditionalGuest' | 'Property', nullable: Whether the debitor is the booker, the primary guest, an additional guest, or the company. When the folio has a company, the only possible value is 'Company'. 'Property' is a reserved type for the house folio.
    - `title` 'Mr' | 'Ms' | 'Dr' | 'Prof' | 'Mrs' | 'Other', nullable: Title
    - `firstName` string, nullable: First name
    - `name` string, nullable: Last name
    - `address` NonStrictAddressModel
      - `addressLine1` string, nullable
      - `addressLine2` string, nullable
      - `postalCode` string, nullable
      - `city` string, nullable
      - `regionCode` string, nullable
      - `countryCode` string, nullable
    - `company` CompanyInfoModel
      - `type` 'CorporateClient' | 'TravelAgency' | 'GovernmentBuyer', nullable: The type of the company. Copied from the linked company when the company is attached to the folio.
      - `identifiers` CompanyIdentifierModel[], nullable: Structured company identifiers. Copied from the linked company when the company is attached to the folio.
        - `scheme` string, required: The identifier scheme (must exist in the company identifier-scheme registry).
        - `value` string, required: The identifier value for the scheme.
      - `name` string, required: Name of the company
      - `taxId` string, nullable: Tax or Vat ID of the company
      - `additionalTaxId` string, nullable: The additional tax ID of the company (e.g. SIRET in France, Codice Destinatario in Italy, SST in Malaysia)
      - `additionalTaxId2` string, nullable: The additional tax ID of the company (e.g. Codice Fiscale in Italy, BRN in Malaysia)
      - `invoiceNetworkIdentity` InvoiceNetworkIdentityModel
        - `network` 'Peppol', required: The Network through which to send the Invoice e. g. Peppol
        - `id` string, required: The Id of the company at the network. e.g. "0208:123456789"
    - `personalTaxId` string, nullable: Debitor's Tax Id if debitor is a person
    - `reference` string, nullable: Any additional information about the debitor that should be present on the invoice
    - `email` string, nullable: Debitor's email
    - `phone` string, nullable: Debitor's phone
  - `type` 'Guest' | 'External' | 'Booking', nullable: The type of the folio to create. Default is the guest folio. This field will become required 01.11.2019.
  - `propertyId` string, nullable: The ID of the property for which an external folio should be created.
  - `code` string, nullable: Optional code for external folios. If present, the id of the folio will be propertyId-code (MUC-SOMETHING); If no code is provided, the id of the folio will be propertyId-ext-number (MUC-EXT-282).

## Response `201`

Success

- FolioCreatedModel
  - `id` string, required: The folio 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)