MUmuralpay
Associated Persons

Create an associated person

Changed on

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 ten beneficial owners. The same individual can act as both.

post/api/compliance/{organizationId}/associated-persons

Request

Path parameters

organizationIdstring uuid required

Request body

relationshipsstring[] required

The relationship(s) of this person to the business.

  • BENEFICIAL_OWNER — holds an ownership stake in the business. Declare owners with 10% or more ownership; if there are no owners at 10% 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.

Example request

{
  "relationships": [
    "BENEFICIAL_OWNER"
  ]
}

Response

Associated person created.

associatedPersonIdstring uuid required

Associated person UUID.

relationshipsstring[] required

The relationship(s) of this associated person to the business. A person can be both a beneficial owner and a control person.

createdAtstring required

ISO 8601 timestamp when the associated person was created.

updatedAtstring required

ISO 8601 timestamp when the associated person was last updated.

Example response

{
  "relationships": [
    "BENEFICIAL_OWNER"
  ],
  "createdAt": "2026-02-24T12:00:00.000Z",
  "updatedAt": "2026-02-24T12:00:00.000Z",
  "uploadedAttestations": []
}

Changes

  • 65aadbefe527Revision changes
    • breaking

      removed the required property ////// from the response with the status

    • warning

      added the new SignedAgreementRequiredException enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the required property ////// to the response with the status