Create webinar - Zoho Webinar

Note:

  • This task is applicable to all services except Zoho Creator.
  • Each time the zoho.webinar.createWebinar integration task is executed, it triggers an API request in the back-end. This call is deducted from the external calls limit available for the service from which the task is executed, based on your pricing plan.
  • Only actual executions that receive a response (whether success or failure) are counted, not the number of times the task appears in the script. For example, if zoho.webinar.createWebinar integration task is placed inside a for each task that iterates five times, the number of external calls consumed will be five, even though the task appears only once in the script. 

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"
  }
 }