Get department details by department name - Zoho Webinar

Note:

  • This task is applicable to all services except Zoho Creator.
  • Each time the zoho.webinar.getDepartmentByName 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.getDepartmentByName 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 fetch department details by department name in Zoho Webinar.

This task is based on Zoho Webinar API: Department details by Department Name

Syntax:

<variable> = zoho.webinar.getDepartmentByName(<portal_id>, <department_name>, <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.
<department_name>TEXTSpecifies the name of the department to be fetched.
<connection>TEXT

Specifies the link name of the Zoho Webinar connection.

Required scope for this connection: ZohoWebinar.department.READ 

Example: Fetching department details by department name.

response = zoho.webinar.getDepartmentByName(86367739,"WEBINAR","webinar1");

where:

response
The KEY-VALUE returned by Zoho Webinar.
86367739
The NUMBER representing the portal identifier.
"WEBINAR"
The TEXT representing the department name.
"webinar1"
The TEXT representing the connection name.

Sample response

Success response

{
  "representation": {
    "departmentId": "645551000000025019"
  }
}
 

Failure response

{
  "error": {
    "code": 1032,
    "message": "This department name is not available"
  }
}