Create New Tags

Purpose

To create new tags.

Request URL

https://recruit.zoho.com/recruit/v2/settings/tags?module={module_api_name}

module_api_name - The API name of the module

Request Method

POST

Scope

scope=ZohoRECRUIT.settings.all
(or)
scope=ZohoRECRUIT.settings.tags.{operation_type}

Possible module names	Possible operation types
candidate, jobopening, submission, offers, interview, client, contact, department, vendors, application and custommodule.	ALL - Full data access WRITE - Edit tag data CREATE - Create tag data

Parameters

Parameter Name	Data Type	Description
module (mandatory)	String	Specify the API name of the module such as Candidates, Contacts, Job Openings, Interviews, etc,.

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/settings/tags?module=Candidates" -
    X POST -
    H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    --data - raw '{
    "tags": [
        {
            "name": "Manager",
            "color_code": "#F17574"
        },
        {
            "name": "Intern",
            "color_code": "#F17574"
        }
    ]
}'

Sample Response

Copied{
    "tags": [
        {
            "code": "SUCCESS",
            "details": {
                "created_time": "2020-08-22T21:07:29+05:30",
                "modified_time": "2020-08-22T21:07:29+05:30",
                "modified_by": {
                    "name": "Patricia Boyle",
                    "id": "486812000000216003"
                },
                "id": 486812000001660114,
                "created_by": {
                    "name": "Patricia Boyle",
                    "id": "486812000000216003"
                }
            },
            "message": "tags created successfully",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "created_time": "2020-08-22T21:07:29+05:30",
                "modified_time": "2020-08-22T21:07:29+05:30",
                "modified_by": {
                    "name": "Patricia Boyle",
                    "id": "486812000000216003"
                },
                "id": 486812000001660113,
                "created_by": {
                    "name": "Patricia Boyle",
                    "id": "486812000000216003"
                }
            },
            "message": "tags created successfully",
            "status": "success"
        }
    ]
}