Skip to main content

Add Trainer API

This API is used to add a new trainer in LMS.

Request URL: 

https://people.zoho.com/api/v1/trainers?erecnosList=<erecnosList>

Scope:

ZOHOPEOPLE.training.ALL
OR
ZOHOPEOPLE.training.CREATE

Possible Operation Types:

ALL - Complete access to data
CREATE - Only to create data

Method:

PUT

Request Parameters

ParametersValues AllowedDefault ValueDescription
*erecnosList <parameters in JSONArray><Mandatory>Specify the employee erecno's

*mandatory parameters

Error Codes and Descriptions

Status CodesDescription
400Invalid parameter value/input parameter missing
403Sorry! You are not authorized to do this operation
404Not found
422Maximum limit exceeded
500Sorry! Server error occured

View complete list of LMS API error codes

Threshold Limit: 30 requests | Lock period: 5 minutes

Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.

Request

Copiedimport okhttp3.*;

public class Main {
    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient();

        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType, "{ \"erecnosList\": [\"478346000011341865\", \"478346000000248077\"] }");

        Request request = new Request.Builder()
            .url("https://people.zoho.com/api/v1/trainers")
            .put(body)
            .addHeader("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .addHeader("Content-Type", "application/json")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
Copiedconst url = "https://people.zoho.com/api/v1/trainers";

const body = JSON.stringify({
    erecnosList: ["478346000011341865", "478346000000248077"]
});

fetch(url, {
    method: "PUT",
    headers: {
        "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    body: body
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
Copiedcurl -X PUT "https://people.zoho.com/api/v1/trainers" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"erecnosList":["478346000011341865","478346000000248077"]}'
Copiedurl = "https://people.zoho.com/api/v1/trainers";

headers = map();
headers.put("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN");
headers.put("Content-Type", "application/json");

body = map();
body.put("erecnosList", list("478346000011341865", "478346000000248077"));

response = invokeurl
[
    url : url
    type : PUT
    parameters: body
    headers: headers
];

info response;
Copiedimport requests

url = "https://people.zoho.com/api/v1/trainers"

headers = {
    "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

payload = {
    "erecnosList": ["478346000011341865", "478346000000248077"]
}

response = requests.put(url, headers=headers, json=payload)

print(response.text)

Show full

Show less

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Response

Copied{
    "trainers": [
        {
            "erecno": "219225000000036453",
            "displayName": "Henry",
            "employeeId": "0001",
            "displayPictureURL": "https://contacts.zoho.com/file?ID=2232855&fs=thumb",
            "trainerId": "219225000000185019"
        }
    ],
    "code": "200",
    "message": "success"
}