---
title: "Create an accounts receivable ledger"
method: POST
path: "/accounting/v1.0/accounts-receivable-ledgers"
tags: ["Accounts Receivable Ledger"]
---

# Create an accounts receivable ledger

`POST /accounting/v1.0/accounts-receivable-ledgers`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/accounting/v1.0/accounts-receivable-ledgers`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Implicit: `https://hotels.cloudbeds.com/api/v1.2/oauth`
    - Scopes: `write:payment`

Create a new accounts receivable (AR) ledger for a property. An AR ledger provides a way to track outstanding balances outside of a reservation, such as invoices sent to a corporate client. You must provide a name, and can optionally link the ledger to a profile.

## Headers

- `X-Property-ID` integer, required

## Request body

- AccountsReceivableLedgerPostRequest
  - `name` string, required
  - `description` string
  - `profileId` integer: Linkage with Profile ID

## Response `200`

OK

- AccountsReceivableLedgerResponse
  - `id` string
  - `name` string
  - `description` string
  - `status` 'OPEN' | 'CLOSED': Status of an accounts receivable ledger. OPEN ledgers can receive balance transfers and payments. CLOSED ledgers are settled and no longer accept new transactions.
  - `propertyId` string
  - `profileId` string, int64: Profile ID associated with this accounts receivable ledger
  - `total` number: Total amount of all charges transferred to this AR ledger, in the smallest currency unit.
  - `paid` number: Total amount of payments applied to this AR ledger, in the smallest currency unit.
  - `balance` number: Outstanding balance (total minus paid), in the smallest currency unit.
  - `createdAt` string: Created datetime (ISO 8601) in UTC
  - `updatedAt` string: Updated datetime (ISO 8601) in UTC

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/cloudbeds/apis/accounting-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/accounting-api/revisions/0b58c698deef?raw)