Create a Service/Part

Purpose

To insert a new service/part record.

Request URL

https://fsm.zoho.com/fsm/v1/Service_And_Parts

Request Method

POST

Scope

scope=ZohoFSM.modules.Service_And_Parts.CREATE

Input JSON Keys

NameDescriptionType
Name
(mandatory)
The name of the service or partString
Unit_Price
(mandatory)
The unit price for the service or partInteger
Type
(mandatory)
Specify whether Service or PartString
The following tax parameters will differ based on the edition chosen:
Taxable
(mandatory)
Whether taxable is true or falseBoolean
Tax_Name
(mandatory)
Tax name if taxable is trueString
Tax_Exemption_Code
(mandatory)
Tax exemption code if taxable is falseString
Inter_State_Tax_Rate
(mandatory)
Applicable for the Indian editionString
Intra_State_Tax_Rate
(mandatory)
Applicable for the Indian editionString
Service_Tasks

Details of the service tasks you want to add to a service:

  • Name of the service task
  • Description of the service task
  • Duration of the service task in minutes
  • Sequence: The order in which the service tasks will be added to the service

JSON Array

String

String

String

String

Sample Request

Copiedcurl --location --request POST 'https://fsm.zoho.com/fsm/v1/Service_And_Parts' \
--header 'Authorization: Zoho-oauthtoken 1000.26xxxxxxxxxx.xxxxxxxxxx0' \
--header 'content-type: application/json' \
--data "@newService.json"

Sample Input

Copied{
    "data": [
        {
            "Name": "Home Painting",
            "Description": "Covers both interior and exterior painting and is tailored to meet your style preferences, functional needs, and budget.",
            "Unit": "Hours",
            "Unit_Price": 100,
            "Work_Type": null,
            "Tax": {
                "Taxable": true,
                "Tax_Name": null,
                "Tax_Id": null,
                "Tax_Exemption_Id": null,
                "Tax_Exemption_Code": null
            },
            "Type": "Service",
            "Service_Tasks": [
                {
                    "Name": "Clean and prep wall",
                    "Description": null,
                    "Duration": 180,
                    "Sequence": 1
                },
                {
                    "Name": "Sand or repair surfaces",
                    "Description": null,
                    "Duration": 180,
                    "Sequence": 2
                },
                {
                    "Name": "Apply primer",
                    "Description": null,
                    "Duration": 180,
                    "Sequence": 3
                }
            ]
        }
    ]
}

Sample Response

Copied{
    "result": "success",
    "code": "SUCCESS",
    "data": {
        "Service_And_Parts": [
            {
                "UID": "Service_And_Parts_0",
                "Modified_Time": "2025-01-06T17:50:13+05:30",
                "Modified_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "Created_Time": "2025-01-06T17:50:13+05:30",
                "id": "1439000001465180",
                "Created_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "TabName": "Products"
            }
        ],
        "Service_Tasks": [
            {
                "UID": "Service_And_Parts_0_Service_Tasks_0",
                "Modified_Time": "2025-01-06T17:50:13+05:30",
                "Modified_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "Created_Time": "2025-01-06T17:50:13+05:30",
                "id": "1439000001465184",
                "Created_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "TabName": "ServiceTasks"
            },
            {
                "UID": "Service_And_Parts_0_Service_Tasks_1",
                "Modified_Time": "2025-01-06T17:50:13+05:30",
                "Modified_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "Created_Time": "2025-01-06T17:50:13+05:30",
                "id": "1439000001465185",
                "Created_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "TabName": "ServiceTasks"
            },
            {
                "UID": "Service_And_Parts_0_Service_Tasks_2",
                "Modified_Time": "2025-01-06T17:50:13+05:30",
                "Modified_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "Created_Time": "2025-01-06T17:50:13+05:30",
                "id": "1439000001465186",
                "Created_By": {
                    "name": "Mary Cooper",
                    "id": "1439000000161001"
                },
                "TabName": "ServiceTasks"
            }
        ]
    },
    "status": "success"
}