Create webinar - Zoho Webinar

Note: This task is applicable to all services except Zoho Creator.

Overview:

This task is used to create and schedule a new webinar with the specified webinar details in Zoho Webinar.

This task is based on Zoho Webinar API: Create a webinar

Syntax:

<variable> = zoho.webinar.createWebinar(<portal_Id>,<webinar_json>,<connection>);

where:

ParamsData typeDescription
<variable>KEY-VALUESpecifies the variable that will hold the response returned by Zoho Webinar.
<portal_Id>NUMBER

Specifies the unique portal identifier where the webinar will be created.

Note: Portal_Id can be fetched in the following ways.

  • From the URL of the application while accessing it. The URL is in the format webinar.zoho.com/webinar/portal_Id/department_Id/home
  • Get portal ID from Zoho Webinar API, where ZSOID represents the portal ID.
<webinar_json>KEY-VALUESpecifies the content of the webinar details, where each key represents a webinar field (e.g., topic, startTime, duration) and the value represents the corresponding data to create the webinar.
<connection>TEXT

Specifies the link name of the Zoho Webinar connection.

Required scope for this connection: ZohoWebinar.webinar.CREATE

Example: Creating a webinar with webinar details.

The following script creates a new webinar with the specified webinar details in Zoho webinar.

webinarjson = Map();
webinarjson.put("topic", "deluge webinar");
webinarjson.put("agenda", "The webinar about the deluge function");
webinarjson.put("presenter", 675xxxx);
webinarjson.put("startTime", "Jun 19, 2026 04:00 PM");
webinarjson.put("duration",3600000);
webinarjson.put("timezone","Asia/Calcutta");
 
response = zoho.webinar.createWebinar(9903xxxx,webinarjson,"webinar");

where:

response
Is the KEY-VALUE returned by Zoho Webinar. It represents the webinar details.
"9903xxxx"
Is the NUMBER unique portal identifier where the webinar will be created.
"webinarjson"
Is the KEY-VALUE variable that holds the values of the webinar created.
"webinar"
Is the TEXT that represents the name of the connection.

Sample response

Success response

The success response returned is in the following format.

 {
  "session": {
    "departmentName": "My Department",
    "regEmbedURL": "https://webinar.zoho.com/meeting/register/embed?sessionId=1013278249",
    "presenter": 67517985,
    "offset": "19800000",
    "timezone": "Asia/Calcutta",
    "departmentId": "34353535352242",
    "creatorZuid": "1343435",
    "isDepartmentAdmin": false,
    "endTimeMillisec": 1781868600000,
    "agenda": "The webinar about the deluge function",
    "startLink": "https://webinar.zoho.com/meeting/webinar-start?key=1013278249&x-meeting-org=99031443",
    "presenterEmail": "test.nm@zoho.com",
    "duration": 3600000,
    "recurringType": 0,
    "registrationLink": "https://webinar.zoho.com/meeting/register?sessionId=1013278249",
    "sys_id": "640967000000131029",
    "startTimeMillisec": 1781865000000,
    "instanceId": [
      "640967000000131029"
    ],
    "conferenceId": [
      "640967000000131033"
    ],
    "sessionType": "webinar",
    "topic": "deluge webinar",
    "startTime": "Jun 19, 2026 04:00 PM IST",
    "endTime": "Jun 19, 2026 05:00 PM IST",
    "meetingKey": "1013278249"
  }
 }
 

Failure response

Sample 1

 {
  "error": {
    "errorCode": 3000,
    "message": "The presenter is not Zoho user. Please enter a valid ZUID.",
    "key": "INVALID_PRESENTER_ID"
  }
 }
 

Sample 2

 {
  "error": {
    "errorCode": 5000,
    "message": "The schedule time must be in the future time.",
    "key": "INVALID_TIME"
  }
 }