---
title: "Create a Holder"
method: POST
path: "/v1/organizations/{organization_id}/holders"
tags: ["Holders API"]
---

# Create a Holder

`POST /v1/organizations/{organization_id}/holders`

## Path parameters

- `organization_id` string, uuid, required

## Headers

- `Content-Type` string
- `X-Request-Id` string, uuid
- `Authorization` string
- `X-Idempotency` string
- `X-TTL` integer

## Request body

- Holder
  - `addresses` Addresses
    - `additional1` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
    - `additional2` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
    - `primary` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
  - `contact` Contact
    - `mobilePhone` string
    - `otherPhone` string
    - `primaryEmail` string
    - `secondaryEmail` string
  - `createdAt` string, date-time, required
  - `deletedAt` string, date-time, nullable, required
  - `document` string
  - `externalId` string
  - `id` string, uuid
  - `legalPerson` LegalPerson
    - `activity` string
    - `foundingDate` string, date
    - `representative` Representative
      - `document` string
      - `email` string
      - `name` string
      - `role` string
    - `size` string
    - `status` string
    - `tradeName` string
    - `type` string
  - `metadata` object
  - `name` string
  - `naturalPerson` NaturalPerson
    - `birthDate` string, date
    - `civilStatus` string
    - `fatherName` string
    - `favoriteName` string
    - `gender` string
    - `motherName` string
    - `nationality` string
    - `socialName` string
    - `status` string
  - `type` string
  - `updatedAt` string, date-time, required

## Response `200`

OK

- Holder
  - `addresses` Addresses
    - `additional1` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
    - `additional2` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
    - `primary` Address
      - `city` string, required
      - `country` string, required
      - `description` string
      - `line1` string, required
      - `line2` string, nullable, required
      - `state` string, required
      - `zipCode` string, required
  - `contact` Contact
    - `mobilePhone` string
    - `otherPhone` string
    - `primaryEmail` string
    - `secondaryEmail` string
  - `createdAt` string, date-time, required
  - `deletedAt` string, date-time, nullable, required
  - `document` string
  - `externalId` string
  - `id` string, uuid
  - `legalPerson` LegalPerson
    - `activity` string
    - `foundingDate` string, date
    - `representative` Representative
      - `document` string
      - `email` string
      - `name` string
      - `role` string
    - `size` string
    - `status` string
    - `tradeName` string
    - `type` string
  - `metadata` object
  - `name` string
  - `naturalPerson` NaturalPerson
    - `birthDate` string, date
    - `civilStatus` string
    - `fatherName` string
    - `favoriteName` string
    - `gender` string
    - `motherName` string
    - `nationality` string
    - `socialName` string
    - `status` string
  - `type` string
  - `updatedAt` string, date-time, required

## 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)