Assign Skill To User

Purpose

To assign a skill to a user.

Request URL

https://fsm.zoho.com/fsm/v1/users/<user_id>/Skills

user_id - The ID of the user.

Request Method

POST

Scope

scope=ZohoFSM.users.CREATE

Input JSON Keys

Name	Description	Type
Skill (mandatory)	The ID of the skill.	String
Rating	The proficiency level of the crew for this skill. The maximum value that can be assigned is 100.	Integer
Description	Details of any certification done by the crew.	String
Certificate_Id	A unique identifier for the certification.	String
Issuing_Authority	The type of body or agency that has issued the certificate. The values allowed are: Government Agencies, Professional Associations, Industry Certification Bodies, Private Companies/Corporations, Trade Unions, NGOs	String
Issue_Date	The date the certificate was issued. The value must be in the ISO format: YYYY-MM-DD.	Date
Expiry_Date	The date by which the validity of the certificate will expire. The value must be in the ISO format: YYYY-MM-DD.	Date
Renewal_Status	The renewal status of the certification. The values allowed are: Completed, Pending	String
Certificate_Type	The category of the certification. The values allowed are: Optional, Mandatory	String

Sample Request

Copiedcurl --request POST 'https://fsm.zoho.com/fsm/v1/users/6191XXXX7001/Skills' \
--header 'Authorization: Zoho-oauthtoken 1000.26xxxxxxxxxx.xxxxxxxxxx0' \
--header 'content-type: application/json' \
--data "{"field1":"value1","field2":"value2"}"

Sample Input

Copied{
    "data": [
        {
            "Skill": "1439000000226010",
            "Rating": 50,
            "Description": "Expertise in installing air conditioning systems, including unit setup, electrical connections, and ensuring optimal performance and safety compliance.",
            "Certificate_Id": "56789012",
            "Issuing_Authority": "Government Agencies",
            "Issue_Date": "2026-01-01",
            "Expiry_Date": "2031-12-31",
            "Renewal_Status": "Completed",
            "Certificate_Type": "Mandatory"   
        }
    ]
}

Sample Success Response

Copied{
    "data": [
        {
            "result": "success",
            "code": "SUCCESS",
            "data": {
                "Skills": [
                    {
                        "UID": "Skills_0",
                        "Modified_Time": "2026-04-13T14:51:23+05:30",
                        "Modified_By": {
                            "name": "Marianne Sheehan",
                            "id": "1003000000208001"
                        },
                        "Created_Time": "2026-04-13T14:51:23+05:30",
                        "id": "1003000004333022",
                        "Created_By": {
                            "name": "Marianne Sheehan",
                            "id": "1003000000208001"
                        },
                        "TabName": "ServiceResourceSkillRell"
                    }
                ]
            },
            "status": "success"
        }
    ]
}

Sample Failure Response

Copied{
    "code": "INVALID_DATA",
    "details": {
        "Skills": [
            {
                "UID": "Skills_0",
                "code": "DUPLICATE_RECORD",
                "details": {},
                "message": "This skill is already assigned to the user. Are you sure you want to create another one?",
                "status": "error"
            }
        ]
    },
    "message": "invalid data",
    "status": "error"
}