---
title: "POST /companies/{companySlug}/recurringInvoices"
method: POST
path: "/companies/{companySlug}/recurringInvoices"
tags: ["recurring invoices"]
---

# POST /companies/{companySlug}/recurringInvoices

`POST /companies/{companySlug}/recurringInvoices`

## Request

- Base URL: `https://api.fiken.no/api/v2`
- URL: `https://api.fiken.no/api/v2/companies/{companySlug}/recurringInvoices`
- Auth: OAuth 2
  - Authorization code: `https://fiken.no/oauth/authorize`
  - Token URL: `https://fiken.no/oauth/token`

Creates a recurring invoice for a single customer. This corresponds to "Repeterende faktura" in Fiken.
The number series for recurring invoices must already exist; if it does not, create the first
recurring invoice in Fiken Web.

## Request body

- RecurringInvoiceRequest: Creates a recurring invoice for a single customer. This corresponds to a recurring invoice in Fiken ("Repeterende faktura"). The amount is derived from the lines.
  - `uuid` string: Optional UUID. If not provided, the API will generate one.
  - `customerId` integer, required: customerId = contactId where customer = true
  - `contactPersonId` integer: Id of the contact person. Must be associated with the provided customer.
  - `startDate` string, date, required: First issue date of the recurring invoice.
  - `endDate` string, date: Optional date after which no more invoices are generated.
  - `daysUntilDueDate` integer, required: Days until due date for each generated invoice.
  - `frequency` Frequency, required: How often an invoice is generated, e.g. interval 1 + intervalUnit MONTH means once per month.
    - `interval` integer, required: Number of interval units between each generated invoice. Must be at least 1.
    - `intervalUnit` 'DAY' | 'WEEK' | 'MONTH', required: The unit of time between each generated invoice.
  - `currency` string: ISO 4217 currency code. Defaults to "NOK" if unspecified.
  - `bankAccountNumber` string, required
  - `iban` string
  - `bic` string
  - `invoiceText` string: Comment/description printed above the invoice lines.
  - `yourReference` string
  - `ourReference` string
  - `orderReference` string: Reference if sending invoice via EHF.
  - `lines` InvoiceishDraftLine[], required
    - `invoiceishDraftLineId` integer: Unique draft line ID
    - `lastModifiedDate` string, date: Date that the draft line was last modified in Fiken, format yyyy-mm-dd.
    - `productId` integer: Product to be credited/debited on invoice draft line.
    - `description` string: Description of the invoiced product or service.
    - `unitPrice` integer: Net price per unit in invoice currency (in cents).
    - `vatType` string: Vat Types for SALES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, EXEMPT_IMPORT_EXPORT, EXEMPT, OUTSIDE, EXEMPT_REVERSE] Vat Types for PURCHASES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, HIGH_DIRECT, HIGH_BASIS, MEDIUM_DIRECT, MEDIUM_BASIS, NONE_IMPORT_BASIS, HIGH_FOREIGN_SERVICE_DEDUCTIBLE, HIGH_FOREIGN_SERVICE_NONDEDUCTIBLE, LOW_FOREIGN_SERVICE_DEDUCTIBLE, LOW_FOREIGN_SERVICE_NONDEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_DEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_NONDEDUCTIBLE]
    - `quantity` number, required: Number of units to be invoiced.
    - `discount` number: Percentage discount charged on invoice draft line. Should be a value between 0 and 100. Can be decimal values such as 25.5
    - `comment` string: Additional information to be printed on invoice.
    - `incomeAccount` string: Field is similar to vatType, it defaults to the product's income account. Either the line or the product needs to have an income account set.

## Response `201`

Created

## Changes

- **2026-09-03** `2473dacdb89c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiken/apis/fiken-api/changes/companies/:companySlug/recurringInvoices/post.md)

---

[API](https://skmtc.dev/fiken/apis/fiken-api.md) - [All operations](https://skmtc.dev/fiken/apis/fiken-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiken/apis/fiken-api/revisions/29111da67f94?raw)