---
title: "Begin new customer onboarding application"
method: POST
path: "/onboarding/customers"
tags: ["Onboarding"]
---

# Begin new customer onboarding application

`POST /onboarding/customers`

Permissions required: **Onboarding**
Initiate onboarding application for a new customer of Anchorage Digital

## Request body

- CreateKYCApplicationRequest
  - `applicationType` 'RIA_PC_INSTITUTION' | 'RIA_PC_INDIVIDUAL' — Anchorage Digital provided type of application, RIA_PC_INDIVIDUAL to Onboard RIA Program Customer who is an Individual and RIA_PC_INSTITUTION to Onboard RIA Program Customer that is an Institution.
  - `applicationVersion` integer — Anchorage Digital version of the application. By default, this value is 0.
  - `entries` KYCApplicationEntry[], required — A collection of responses for a set of defined relevant questions.
    - `key` string, required — Identifier of the question.
    - `value` union, required — Answer for the given question.
      - string
      - boolean
      - object
      - object[]
  - `externalId` string — External identifier for the customer onboarding application. This value has to be unique for each customer application.
  - `submit` boolean — Optional parameter to try to submit the application if there are no validation errors. This action is irreversible you cannot update the application values after. You can use this to avoid making another api call to POST /v2/onboarding/customers/submit

## Response `201`

Customer ID and information of the successfully created customer onboarding application

- CreateKYCApplicationResponse
  - `data` CreateKYCApplicationResponseData, required
    - `customerId` string, required — Unique identifier for the customer onboarding application
    - `id` string — DEPRECATED - Use customerId instead
    - `status` string, required — Status of the customer onboarding application, possible values are DRAFT, IN_PROGRESS, IN_REVIEW and COMPLETE

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `501` — Not Implemented
- `503` — Service Unavailable

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)