Start a Trip

Purpose

To start a trip.

Request URL

https://fsm.zoho.com/fsm/v1/Trips/start

Request Method

POST

Scope

scope=ZohoFSM.modules.Trips.CREATE

Input JSON Parameters

Name

Description

Type

Appointment

(mandatory)

The service appointment for which you want to create the trip. You can obtain this ID from the List Service Appointments API.

String

Service_Resource
(mandatory)

The ID of the user for whom you want to create a time off. Use the id in the Service_Resources key present in the List Users API response.

String

Sample Request

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

Sample Input

Copied{
	"data": [
        {
            "Appointment": "1003000004283017",
            "Service_Resource": "1003000000208159"
        }
    ]
}

Sample Success Response

Copied{
    "result": "success",
    "code": "SUCCESS",
    "data": {
        "Trips": [
            {
                "UID": "Trips_0",
                "Modified_Time": "2026-05-06T11:32:06+05:30",
                "Modified_By": {
                    "name": "Marianne Sheehan",
                    "id": "1003000000208001"
                },
                "Created_Time": "2026-05-06T11:32:06+05:30",
                "id": "1003000004509003",
                "Created_By": {
                    "name": "Marianne Sheehan",
                    "id": "1003000000208001"
                },
                "TabName": "Trips"
            }
        ]
    },
    "status": "success"
}

Sample Error Response

Copied{
    "code": "TRIP_ALREADY_OPEN",
    "details": {
        "Trips": [
            {
                "Appointment": {
                    "id": "1003000004283017",
                    "Name": "AP-112"
                },
                "End_Time": null,
                "Start_Time": "2026-05-06T11:31:58+05:30",
                "id": "1003000004509003",
                "Service_Resource": {
                    "id": "1003000000208159",
                    "Name": "Marianne Sheehan"
                },
                "Name": "Trip6"
            }
        ]
    },
    "message": "Another Trip is inprogress for the same user.  Complete the running trip to start new one.",
    "status": "error"
}