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

# Begin new customer subaccount onboarding application

`POST /onboarding/subaccounts`

Permissions required: **Onboarding**

Initiate onboarding application for a new customer subaccount of Anchorage Digital

## Request body

- CreateKYCSubaccountApplicationRequest
  - `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, required — External identifier for the customer subaccount onboarding application. This value has to be unique for each customer subaccount application.
  - `name` string — The name of the subaccount.
  - `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/subaccounts/submit

## Response `201`

Customer subaccount ID and information of the successfully created customer subaccount onboarding application

- CreateKYCSubaccountApplicationResponse
  - `data` CreateKYCSubaccountApplicationResponseData, required
    - `status` string, required — Status of the customer subaccount onboarding application, possible values are DRAFT, IN_PROGRESS, IN_REVIEW and COMPLETE
    - `subaccountId` string, required — Unique identifier for the customer subaccount onboarding application

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