---
title: "Create an account holder."
method: POST
path: "/v2/account-holder"
tags: ["Account Holder"]
---

# Create an account holder.

`POST /v2/account-holder`

Create an account holder and start tracking its ledger. The account holder can be a consumer, business or unknown.

## Request body

- AccountHolderCreate
  - `type` 'consumer' | 'business' | 'unknown', required
  - `name` string, nullable
  - `industry` string, nullable
  - `website` string, nullable
  - `company` AccountHolderCompany
    - `loan_state` 'tbd' | 'ongoing' | 'done', required
    - `logo` string, nullable
  - `id` string, nullable

## Response `200`

The created account holder

- NtropyServerSchemasAccountHolderAccountHolder
  - `type` 'consumer' | 'business' | 'unknown', required
  - `name` string, nullable
  - `industry` string, nullable
  - `website` string, nullable
  - `company` AccountHolderCompany
    - `loan_state` 'tbd' | 'ongoing' | 'done', required
    - `logo` string, nullable
  - `id` string, required
  - `created_at` string, date-time, nullable
  - `mean_labeler_confidence` number, nullable
  - `total_revenue` number, nullable
  - `application_time` string, date-time, nullable
  - `alerts` object
  - `review_percentage` number, nullable

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/ntropy/apis/ntropy-transaction-api.md) · [All operations](https://skmtc.net/ntropy/apis/ntropy-transaction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ntropy/ntropy-transaction-api/versions/47be508488c1/schema)