Connect a Person to a Legal Entity

Developing

POST

/api/legalentities/{legalentityownerid}/legalentities/{legalentityid}/people

Add staff and candidates to legal entities. Before calling this method you need to have already created a legal entity and that legal entity must be a member of a trust group that your organisation owns, any people you want to add must also already have been created as candidates and any roles required must already exist.

If the person already has been added to the legal entity the roles will be updated to match the roles you supply in this call.

The roles supplied must be owned by {legalentityownerid} or have a parent trust group that {legalentityownerid} is a member of.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "people": [
        {
            "candidateId": 8860790,
            "roles": [
                3782,
                4389
            ]
        },
        {
            "candidateId": 6705288,
            "roles": [
                3782
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tahdah.me/api/legalentities//legalentities//people' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "people": [
        {
            "candidateId": 8860790,
            "roles": [
                3782,
                4389
            ]
        },
        {
            "candidateId": 6705288,
            "roles": [
                3782
            ]
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{}

Modified at 2025-06-05 15:46:57

Create Legal Entity

Create Candidate