Create Modules API

This API is used to create modules in courses or batches in LMS

Request URL: (Self Paced Course)

https://people.zoho.com/api/v1/courses/<courseId>/modules?moduleData={"name" : <name>, "duration" :<duration>, "description" : <description>, "lockType" : <lockType>, "lockUntil" : <lockUntil>}

Request URL: (Blended Learning Course)

https://people.zoho.com/api/v1/courses/<courseId>/batches/<batchId>/modules?moduleData={"name" : <name>, "duration" :<duration>, "description" : <description>, "lockType" : <lockType>, "lockUntil" : <lockUntil>}

Scope:

ZOHOPEOPLE.training.ALL
OR
ZOHOPEOPLE.training.CREATE

Possible Operation Types:

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

Method:

POST

Request Parameters

Parameters	Values Allowed	Default Value	Description
*moduleData	<parameters in JSON Object>		JSON Input

Parameters	Values Allowed	Default Value	Description
*name	<file name>	<Mandatory>	Specify the module name
duration	<Duration in minutes>	-	Specify the duration
description	<Description>	-	Specify the description
lockType	<0\|1\|2>	0	0 -> Unlock 1 -> Locked until date 2 -> Locked until previous module completed
lockUntil	<lockUntil date in DD-MM-YYYY format>	-	Specify the lockUntil date

*mandatory parameters

Error Codes and Descriptions

Status Codes	Description
400	Invalid parameter value/input parameter missing
403	Sorry! You are not authorized to do this operation
404	Not found
422	Maximum limit exceeded
500	Sorry! 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

Java JavaScript Curl Deluge Python

Copiedimport okhttp3.*;

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

        String url = "https://people.zoho.com/api/v1/courses/478346000019157017/modules";

        Request request = new Request.Builder()
            .url(url)
            .post(RequestBody.create(new byte[0])) // Empty payload
            .addHeader("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}

Copiedconst url = "https://people.zoho.com/api/v1/courses/478346000019157017/modules";

fetch(url, {
    method: "POST",
    headers: {
        "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN"
    },
    body: null // Empty payload
})
.then(response => response.text())
.then(data => console.log(data))
.catch(error => console.error(error));

Copiedcurl -X POST "https://people.zoho.com/api/v1/courses/478346000019157017/modules" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN"

Copiedurl = "https://people.zoho.com/api/v1/courses/478346000019157017/modules";

headers = map();
headers.put("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN");

response = invokeurl
[
    url : url
    type : POST
    headers: headers
];

info response;

Copiedimport requests

url = "https://people.zoho.com/api/v1/courses/478346000019157017/modules"

headers = {
    "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN"
}

response = requests.request("POST", url, headers=headers)

print(response.text)

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Response

Copied{
    "code": 200,
    "module": {
        "duration": "100 Mins",
        "lockUntil": "27-12-2021",
        "isLocked": true,
        "moduleName": "Module One",
        "description": "Description for module",
        "lockType": "1",
        "moduleId": "219225000000648015"
    },
    "message": "success"
}