Get Department Details by Department ID - Zoho Webinar

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

Overview:

This task is used to get the department details by department ID in Zoho Webinar.

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

Syntax:

<variable> = zoho.webinar.getDepartmentById(<portal_id>, <department_id>, <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_Id>NUMBERSpecifies the unique identifier of the department to be fetched.
<connection>TEXTSpecifies the link name of the Zoho Webinar connection. 
Required scope for this API connection: ZohoWebinar.department.READ

Example: Fetching department details with department ID.

The following script fetches the department details with the department ID in Zoho Webinar.

response = zoho.webinar.getDepartmentById(8636xxxx,64555100000002xxx,"webinar");

where:

response
Is the KEY-VALUE returned by Zoho Webinar. It represents the department details.
8636xxxx
Is the NUMBER of the unique portal identifier where the department details will be fetched from.
64555100000002xxx
Is the NUMBER of the unique identifier of the department to be fetched.
"webinar"
Is the TEXT that represents the name of the connection.

Sample response

Success response

{
  "representation": {
    "departmentId": "645551000000025019",
    "departmentName": "My Department",
    "source": "MEETING",
    "createdTime": "1742208058807",
    "modifiedTime": "1742208058807",
    "adminUserIds": [
      "645551000000025065"
    ],
    "memberUserIds": []
  },
  "resourceType": "/api/v2/86367739/department/645551000000025019"
}
 

Failure response

{
  "error": {
    "code": 1025,
    "message": "Org doesn't matches with request uri"
  },
  "resourceType": "/api/v2/8636779/department"
}