---
title: "Create loan product accounting profile"
method: POST
path: "/api/v1/loan-products/{id}/accounting-profiles"
tags: ["LoanProducts"]
---

# Create loan product accounting profile

`POST /api/v1/loan-products/{id}/accounting-profiles`

Configures the accounting profile for a loan product version that belongs to the path loan product.

## Path parameters

- `id` string, uuid, required — Loan product identifier.

## Request body

- ConfigureAccountingProfileHumaInputBody
  - `accountingMode` 'accrual' | 'cash', required — Accounting recognition mode.
  - `loanProductVersionId` string, uuid, required — Loan product version identifier.
  - `midazLedgerId` string — Optional per-product Midaz ledger the profile's postings route into; both-or-neither with midazOrganizationId. Required under multi-tenant mode; empty single-tenant profiles fall back to the env default.
  - `midazOrganizationId` string — Optional per-product Midaz organization the profile's postings route into; both-or-neither with midazLedgerId. Required under multi-tenant mode; empty single-tenant profiles fall back to the env default.
  - `postingRules` PostingRuleHumaInputBody[], required — Non-null GL account mappings per accounting event. New profiles require disbursement, repayment, prepayment, accrual, collection_unapplied, collection_reapply, and collection_refund; accrual_tax is optional.
    - `eventType` 'disbursement' | 'repayment' | 'prepayment' | 'accrual' | 'accrual_tax' | 'collection_unapplied' | 'collection_reapply' | 'collection_refund', required — Accounting event type.
    - `legs` PostingLegHumaInputBody[], required — Non-null ordered posting legs. Prepayment requires exactly five legs in this component order: cash, charge_rebate, iof_refund, principal, iof_due; cash is a required debit, principal is a required credit, and the three component legs are optional with the corresponding sides. Other events require at least one debit and one credit.
      - `account` string, required — GL account for this leg.
      - `component` string — Open withholding component code (e.g. "iof"); set this XOR role.
      - `optional` boolean — Whether a component amount may be omitted or zero at posting time. Permitted only on component legs; omitted defaults to false.
      - `role` 'principal' | 'interest' | 'iof' | 'tax' | 'cash' | 'unapplied_cash' | 'counterparty' — Reserved economic role of this leg; set this XOR component.
      - `side` 'debit' | 'credit', required — Whether this leg debits or credits the account.
    - `metadata` object — Optional metadata.

## Response `201`

Created

- AccountingProfileHumaBody
  - `accountingMode` string, required — Accounting recognition mode (accrual|cash).
  - `createdAt` string, required — Creation timestamp (RFC3339, UTC).
  - `id` string, required — Server-assigned accounting profile identifier (uuid).
  - `loanProductVersionId` string, required — Loan product version this profile is configured for (uuid).
  - `postingRules` AccountingPostingRuleHumaBody[], nullable, required — Persisted GL account mappings, one per accounting event.
    - `eventType` string, required — Accounting event type (disbursement|repayment|prepayment|accrual|accrual_tax|collection_unapplied|collection_reapply|collection_refund).
    - `legs` AccountingPostingLegBody[], required — Persisted ordered posting legs.
      - `account` string, required — GL account for this leg.
      - `component` string — Open withholding component code (set XOR role).
      - `optional` boolean, required — Whether the component amount may be absent or zero for a generated posting.
      - `role` 'principal' | 'interest' | 'iof' | 'tax' | 'cash' | 'unapplied_cash' | 'counterparty' — Reserved economic role of this leg (set XOR component).
      - `side` 'debit' | 'credit', required — Whether this leg debits or credits the account.
    - `metadata` object, required — Optional metadata carried with the rule.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)