---
title: "Create customer associate"
method: POST
path: "/platform/v2/customers/{customerId}/associates"
tags: ["Customers"]
---

# Create customer associate

`POST /platform/v2/customers/{customerId}/associates`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/platform/v2/customers/{customerId}/associates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/platform/v2/customers/:customerId/associates/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an associate under a customer onboarding application. The `entity` payload is discriminated by `type`: use `PERSON` for a natural person (UBO, director, signatory, account representative) or `BUSINESS_REGISTRATION` for a registered-business owner.

## Path parameters

- `customerId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- V2CreateAssociateRequest: Create an associate under a customer onboarding application.
  - `types` string[], required
  - `entity` union, required: Create-time associate entity. `type` discriminates between `PERSON` and `BUSINESS_REGISTRATION`.
    - V2PersonCreateEntity: Create a natural-person associate. `type` must be `PERSON`.
      - `type` 'PERSON', required
      - `firstName` string, required
      - `lastName` string, required
      - `email` string, email, required
      - `phoneNumber` string: Phone number in E.164.
      - `dateOfBirth` string, date
      - `nationality` string
      - `secondNationality` string
      - `birthCountryCode` string
      - `taxIdentificationNumber` string
      - `taxResidence` string
      - `position` string
      - `isPoliticallyExposedPerson` boolean
      - `percentageOfOwnership` string, number
      - `ownershipType` 'DIRECT' | 'INDIRECT'
      - `controlOptions` V2PersonControlOptions: Declared control rights of a natural-person associate.
        - `canAppointDirectors` boolean, required
        - `hasSignificantControl` boolean, required
        - `controlsManagement` boolean, required
        - `controlsCorporateBody` boolean, required
      - `address` V2PersonAddress: Postal address in nested form.
        - `addressLine1` string
        - `addressLine2` string
        - `city` string
        - `postalCode` string
        - `stateCode` string
        - `countryCode` string
    - V2BusinessRegistrationCreateEntity: Create a registered-business associate. `type` must be `BUSINESS_REGISTRATION`.
      - `type` 'BUSINESS_REGISTRATION', required
      - `entityName` string, required
      - `registrationCountry` string, required
      - `registrationNumber` string, required
      - `percentageOfOwnership` string, number
      - `typeOfOwnership` 'DIRECT' | 'INDIRECT'

## Response `200`

Associate created

- object
  - `id` string, uuid: Associate id.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: The specified resource was not found
- `429`: A request with the same `Idempotency-Key` is still being processed. Retry after it completes.

## Changes

- **2026-11-06** `c386d436bf2c`: 2 info
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/platform/v2/customers/:customerId/associates/post.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)