---
title: "Add individual"
method: POST
path: "/v1/customers/individuals"
tags: ["Customers"]
---

# Add individual

`POST /v1/customers/individuals`

Add individual

## Headers

- `Idempotency-Key` string, uuid, nullable

## Request body

- AddIndividualRequest
  - `address` Address, required
    - `country_code` string, string, required
    - `line_1` string, string, required
    - `line_2` string, string, nullable — ***optional*** for `AED` payments but ***mandatory*** for `USD` payments
    - `line_3` string, string, nullable
    - `line_4` string, string, nullable
  - `currency_extra` IndividualCurrencyExtra[], nullable
    - `country_of_birth` string, string, required — Country of birth. it should be ISO3166-1 Alpha2 country code
    - `country_of_issuance` string, string, required — Country where id was issues. it should be ISO3166-1 Alpha2 country code
    - `currency` 'usd', required
    - `id_number` string, string, required — Valid person id number (Passport or national id).
    - `ip_address` string, string — Optional IP address to use as a Proof of Address. Can be in IPv4 or IPv6 format.
    - `occupation_code` string, string, required — US occupation code as defined by the Standard Occupational Classification (SOC) system. See https://reference.fuse.me/soc.html for supported list of codes.
  - `date_of_birth` string, date, required
  - `display_name` string, string, required
  - `first_name` string, string, required
  - `gender` 'male' | 'female' | 'undefined', required
  - `identification` union — Individual Identification Identification document of an individual.
    - object
      - `country_of_issuance` string, string, required — Country of issuance (i.e: US, AE)
      - `expiry_date` string, date, required — Expiry date of the passport.
      - `number` string, string, required — Passport number.
      - `type` 'passport', required
    - object
      - `country_of_issuance` string, string, required — Country of issuance. (i.e: US, AE)
      - `expiry_date` string, date, required — Expiry date of the ID.
      - `number` string, string, required — National ID number.
      - `type` 'national_id', required
  - `last_name` string, string, required
  - `middle_name` string, string, nullable
  - `nationality` string, string, required
  - `reference` string, string, required — Reference set by the customer. Max 36 characters.
  - `relationship_type` union — Represents the relationship between a customer and the organisation.
    - 'direct' — The customer is a direct customer of the organisation. The customer is contracted with the organisation.
    - object — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
      - `indirect` object, required — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
        - `parent_customer_id` string, uuid, required

## Response `201`

Individual has been created successfully

- AddCustomerResponse
  - `id` string, Uuid, required

## Other responses

- `400` — Invalid request
- `401` — Authentication error
- `409` — Conflict error
- `500` — Internal server error

---

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