---
title: "Create an associated person"
method: POST
path: "/api/compliance/{organizationId}/associated-persons"
tags: ["Associated Persons"]
---

# Create an associated person

`POST /api/compliance/{organizationId}/associated-persons`

Creates an associated person — a beneficial owner or control person — and attaches them to the organization. To include them in a business compliance review, reference their ID from the business associated persons attestation. An organization may have one control person and up to four beneficial owners. The same individual can act as both.

## Path parameters

- `organizationId` string, uuid, required

## Request body

- CreateAssociatedPersonRequest
  - `relationships` string[], required — The relationship(s) of this person to the business. - `BENEFICIAL_OWNER` — holds an ownership stake in the business. Declare owners with 25% or more ownership; if there are no owners at 25% or more, report the owner with the highest ownership percentage. The exact `ownershipPercentage` is set on the personal-info attestation. - `CONTROL_PERSON` — has significant management responsibility. A person can hold both roles.

## Response `201`

Associated person created.

- AssociatedPersonResource
  - `associatedPersonId` string, uuid, required — Associated person UUID.
  - `relationships` string[], required — The relationship(s) of this associated person to the business. A person can be both a beneficial owner and a control person.
  - `createdAt` string, required — ISO 8601 timestamp when the associated person was created.
  - `updatedAt` string, required — ISO 8601 timestamp when the associated person was last updated.
  - `requiredAttestations` AssociatedPersonAttestationRequirement[] — Attestation types this associated person still needs before the review can be submitted.
    - `attestationType` 'associatedPersonPersonalInfo' | 'associatedPersonContactInfo' | 'associatedPersonResidentialAddress' | 'associatedPersonTaxInfo' | 'associatedPersonIdentityDocument' | 'associatedPersonProofOfAddress' | 'associatedPersonEeaInfo' | 'associatedPersonProofOfSignatoryAuthority', required — Associated person attestation type required before submitting the compliance review.
  - `uploadedAttestations` AssociatedPersonAttestationSummary[], required — Attestations uploaded for this associated person.
    - `attestationType` 'associatedPersonPersonalInfo' | 'associatedPersonContactInfo' | 'associatedPersonResidentialAddress' | 'associatedPersonTaxInfo' | 'associatedPersonIdentityDocument' | 'associatedPersonProofOfAddress' | 'associatedPersonEeaInfo' | 'associatedPersonProofOfSignatoryAuthority', required — Which associated person attestation this summary refers to.
    - `id` string, uuid, required — Unique attestation ID
    - `validationStatus` union, required — Validations lifecycle state for this attestation.
      - AttestationValidationStatusPending — Validations in progress.
        - `type` 'pending', required
      - AttestationValidationStatusApproved — Attestation passed validations.
        - `type` 'approved', required
      - AttestationValidationStatusFailed — Attestation failed validations.
        - `failures` AttestationValidationFailure[], required — Information about the failed validations for this attestation.
          - `failureCode` 'INCORRECT_DOCUMENT' | 'POOR_QUALITY' | 'MISSING_INFORMATION' | 'INCONSISTENT_DATA' | 'EXPIRED_DOCUMENT' | 'OTHER', required — A reason the validation failed.
          - `severity` 'BLOCKING' | 'WARNING', required — `BLOCKING` must be addressed before submit can succeed; `WARNING` can be resolved by acknowledging warnings at submit-time.
        - `type` 'failed', required

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException
- `422` — ControlPersonAlreadyExistsException MaxBeneficialOwnersExceededException

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/revisions/437d277f5948/schema)