Skip to main content

Get list of members in a department

You can use this API to get a list of all members in a specific department.

API: https://meeting.zoho.com/api/v2/{orgId}/department/{departmentId}/user/member 

Method: Get 

OAuth Scope: ZohoMeeting.department.READ 

Path Params: 
orgId - organization id which is retrieved from currentUser api 
departmentId - department id which is retrieved from get list of department api

Request Example:

Copiedhttps://meeting.zoho.com/api/v2/1234567/department/123456789123/user/member

Response Example:

Copied{
    "representation": [
        {
            "userId": "4021960000000018001",
            "zuid": "813624082",
            "status": "ACTIVE",
            "isConfirmed": true,
            "emailId": "zohomeeting+t1@zohocorp.com",
            "firstName": "Zlyker",
            "lastName": "Meeting",
            "creatorUserId": "1234567890",
            "createdTime": "1686578243910",
            "modifiedTime": "1686578346804",
            "modifiedUserId": "1234567890",
            "meetingLicense": "PRO",
            "webinarLicense": "PRO"
        }
    ],
    "resourceType": "/api/v2/1234567/department/123456789123/user/member"
}

Show full

Show less

POSSIBLE ERROR CASES

1. Invalid DC or Invalid token
 

HTTP Code: 400
HTTP Body:

Copied{
    "error": {
        "code": 2000,
        "message": "INVALID_OAUTHTOKEN"
    }
}

Resolution: Check whether the entered DC is correct and entered token is not expired.

2. Invalid orgId

HTTP Code: 403
HTTP Body:

Copied{
    "error": {
        "code": 1025,
        "message": "Org doesn't matches with request uri"
    },
    "resourceType": "/meeting/api/v2/1234567/user"
}

Resolution: Check whether the entered organization id is correct.

3. Invalid Org Admin

HTTP Code: 403

HTTP Body:

Copied{
    "error": {
        "code": 1009,
        "message": "Invalid org admin"
    },
    "resourceType": "/meeting/api/v2/1234567/user"
}

Resolution: Only admin can access this API. Kindly contact the admin.

4. Limit Exceeded

HTTP Code: 400
HTTP Body:

Copied{
    "error": {
        "code": 1028,
        "message": "Count shouldn't exceed 100"
    },
    "resourceType": "/api/v2/1234567/department"
}

Resolution: Max limit is 100.