Tahdah API
  1. Endpoints
Tahdah API
  • Introduction
  • Webhooks
  • TrustGroups
    • About Trust Groups
    • Endpoints
      • List Trust Groups
      • Create a Trust Group
      • Update Trust Group
      • List Trust Group Legal Entity Members
      • List Trust Group Candidate Members
      • Add Trust Group Member
      • Remove Trust Group Member
    • Webhooks
      • Member Added
      • Member Updated
  • EventCredits
    • Webhooks
      • Event Credits Updated
    • Add Credits to Legal Entity
      PUT
  • Tracker
    • Webhooks
    • Get Candidate Trackers
      GET
    • Get Legal Entity Targets
      GET
  • LearningExperiences
    • EndPoints
      • Register Learners on a Learning Experience
      • Get Learning Experiences
      • Get Learning Experience
    • Webhooks
  • DigitalBadges
    • Issue Digital Badge
      POST
    • Get Badge Templates
      GET
  • LegalEntities
    • Endpoints
      • Legal Entity Details
        GET
      • Create Legal Entity
        POST
      • Connect a Person to a Legal Entity
        POST
    • Webhooks
  • Candidates
    • EndPoints
      • Create Candidate
      • Update a Candidate
      • Delete Candidate
      • Add/Remove tags to a candidate
    • Webhooks
  • Catalogues
    • Endpoints
    • Webhooks
      • Catalogue Entry Created
  • Schemas
    • Inbound
    • Events
      • EventTemplateCreditRequest
      • EventTemplateCredit
    • Catalogue
      • CatalogueEntry
    • TrustGroupMember
    • temp
    • LegalEntity
    • legalEntityIdentifier
    • Candidate
  1. Endpoints

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
Legal Entity Details
Next
Connect a Person to a Legal Entity
Built with