Register Learners on a Learning Experience

Developing

POST

/api/learningexperiences/legalentities/{legalentityid}/experiences/{experienceid}/learners

Registers one or more learners on a learning experience using the tahdah candidate id. Before registering you need to call the create candidate endpoint to create the learner and get their id.

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

{
    "candidateIds": [
        {
            "candidateId": 212233,
            "behavior": 2,
            "registrationDate": "2025-09-03"
        },
        {
            "candidateId": 4211124,
            "behavior": 1,
            "registrationDate": "2024-09-10"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tahdah.me/api/learningexperiences/legalentities//experiences//learners' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "candidateIds": [
        {
            "candidateId": 212233,
            "behavior": 2,
            "registrationDate": "2025-09-03"
        },
        {
            "candidateId": 4211124,
            "behavior": 1,
            "registrationDate": "2024-09-10"
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

[
    {
        "candidateId": "string",
        "candidateExperienceId": "string",
        "registrationDate": "string"
    }
]

Modified at 2025-04-10 23:01:04

Get Legal Entity Targets

Get Learning Experiences