Create Legal Entity

Developing

POST

/api/legalentities/{legalEntityOwnerId}/legalentities

Creates a new legal entity and returns the id of the newly created legal entity. You can also provide a list of trust group ids to add the legal entity to. For details about how trust groups work see https://developers.tahdah.me/about-trust-groups-871670m0

You can also provide your own reference for the legal entity which is searchable within the tahdah system and also can be configured to show as the legal entities main identifier on any web pages linked to them.

The details supplied for legal entity must be unique so if we already have a legal entity with the same name, company number, charity number or your reference in any of your trust groups this method will return the id of the existing legal entity.

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

{
    "legalEntityDetails": {
        "name": "ACME Limited",
        "tradingName": "ACME Training",
        "description": "We train people",
        "logoUrl": "https://www.images.com/image1.png",
        "publicWebsiteAddress": "https://www.acmetraining.com",
        "contactEmail": "contact@acmetraining.com",
        "contactUsLink": "https://www.acmetraining.com/contact-us",
        "vatNumber": "GB12344567",
        "charityNumber": "4",
        "childAgeLimit": 16,
        "address1": "1 ACME Road",
        "address2": "",
        "address3": "",
        "town": "Chipping Norton",
        "county": "Sussex",
        "postcode": "L18PTD",
        "currencyId": 1,
        "timezone": "UK/London"
    },
    "addToTrustGroups": [
        5889,
        5888,
        5902
    ],
    "yourReference": "LE192882"
}

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' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "legalEntityDetails": {
        "name": "ACME Limited",
        "tradingName": "ACME Training",
        "description": "We train people",
        "logoUrl": "https://www.images.com/image1.png",
        "publicWebsiteAddress": "https://www.acmetraining.com",
        "contactEmail": "contact@acmetraining.com",
        "contactUsLink": "https://www.acmetraining.com/contact-us",
        "vatNumber": "GB12344567",
        "charityNumber": "4",
        "childAgeLimit": 16,
        "address1": "1 ACME Road",
        "address2": "",
        "address3": "",
        "town": "Chipping Norton",
        "county": "Sussex",
        "postcode": "L18PTD",
        "currencyId": 1,
        "timezone": "UK/London"
    },
    "addToTrustGroups": [
        5889,
        5888,
        5902
    ],
    "yourReference": "LE192882"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "id": 0
}

Modified at 2025-06-05 15:37:04

Legal Entity Details

Connect a Person to a Legal Entity