Profiles APIs

In Zoho Recruit, the administrator assigns a profile to every user which decides the user's level of access to Zoho Recruit data. Use this API to get the details of different profiles.

Get profiles

Purpose

To retrieve the data of profiles through an API request.

Request URL

https://recruit.zoho.com/recruit/v2/settings/profiles

To get a specific profile;
https://recruit.zoho.com/recruit/v2/settings/profiles/{profile_id}

{profile_id} - The unique ID of the profile

Request Method

GET

Scope

scope=ZohoRecruit.settings.profiles.{operation_type}

Possible operation types
ALL - Full access to profiles data READ - get profile data

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/settings/profiles"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Sample Response

Copied{
   "profiles": [
       {
           "created_time": null,
           "modified_time": null,
           "name": "Administrator",
           "modified_by": null,
           "description": "Complete control over hierarchy set up and data permissions across the organization.",
           "id": "12909000000054127",
           "is_custom": false,
           "created_by": null
       },
       {
           "created_time": null,
           "modified_time": null,
           "name": "Standard",
           "modified_by": null,
           "description": "Can manage end-to-end hiring processes in the organization.",
           "id": "12909000000054129",
           "is_custom": false,
           "created_by": null
       },
       {
           "created_time": null,
           "modified_time": null,
           "name": "Guest",
           "modified_by": null,
           "description": "Can only make interview decisions scheduled to them and log activities to any data",
           "id": "12909000000054131",
           "is_custom": false,
           "created_by": null
       },
       {
           "created_time": null,
           "modified_time": null,
           "name": "Interviewer",
           "modified_by": null,
           "description": "Can only make interview decisions scheduled to them",
           "id": "12909000000054133",
           "is_custom": false,
           "created_by": null
       }
   ]
}