---
title: "Create recurring liability"
method: POST
path: "/api/v1/liabilities-recurring"
tags: ["Liability"]
---

# Create recurring liability

`POST /api/v1/liabilities-recurring`

Creates a single new recurring liability.

## Request body

- object
  - `creationType` string, required — Type of RecurringLiability creation
  - `type` string, required — RecurringLiability type
  - `active` boolean, required — Indicates if the RecurringLiability is active
  - `filter` string — value is booking text for creationType=incoming_payment and day for creationType=date
  - `debit` string — value is debit for creationType=incoming_payment and amount for creationType=date
  - `credit` string — Credit amount
  - `fee` string — RecurringLiability fee
  - `currency` string — value is currency for creationType=incoming_payment,date
  - `contraAccount` string — Contra account description
  - `invoiceNumber` string — Invoice number related to the RecurringLiability
  - `purpose` string — Purpose of the RecurringLiability
  - `costCenter` string — Cost center description
  - `paymentMethod` string — Payment method used
  - `approveGoodsReceiptInspection` boolean — Approval for goods receipt inspection
  - `approveIncomingInvoiceInspection` boolean — Approval for incoming invoice inspection
  - `liabilityAmount` string — Liability amount for the RecurringLiability
  - `liabilityCurrency` string — Liability currency for the RecurringLiability
  - `value` string — value is supplier description for type=liability, contraAccount for type=chart_of_accounts, errorReason for type=import_error

## Response `201`

Resource successfully created response

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)