# Zoho FSM Integration via LowCodeAPI

**Last Updated**: February 10, 2026

## Overview
Field service management

**Categories:**
- {'id': 'zoho-suite', 'name': 'Zoho Suite'}

## Base Endpoint
https://api.lowcodeapi.com/zohofsm

**Important**: Always include the provider name in the URL path after `api.lowcodeapi.com/`

## Authentication
**Type:** OAUTH2.0

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api

## URL Format (Important)

LowCodeAPI supports two URL formats. **Always try the New Format first**, then fall back to Old Format if needed.

### New Format (Priority)
- Path parameters stay in the URL path
- Do NOT include path parameters as query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/{id}?api_token=XXX`

### Old Format (Fallback)
- Path parameters become query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/id?id={id}&api_token=XXX`

### Decision Flow for AI Agents
1. Always use **New Format** first - keep path parameters in the URL path
2. If you get a 404 or error, try **Old Format** with sanitized path
3. Log which format worked for future requests to this provider

## API Categories

## Common Endpoints

### Get an Asset

**Method:** GET
**LowCodeAPI Path:** /fsm/v1/Assets/<record_id>

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/<record_id>?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/assets/record_id?record_id={record_id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| record_id | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/<record_id>?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/get-an-asset.html

### Create an Asset

**Method:** POST
**LowCodeAPI Path:** /fsm/v1/Assets/

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/assets/?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| Company | string |  |
| Contact | string |  |
| Name | string |  |
| Product | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/create-asset.html

### Edit an Asset

**Method:** PUT
**LowCodeAPI Path:** /fsm/v1/Assets/<record_id>

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/<record_id>?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/assets/record_id?record_id={record_id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| record_id | string |  |

**Example Request (New Format):**

```bash
curl -X PUT 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Assets/<record_id>?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/edit-asset.html

### Check In User

**Method:** POST
**LowCodeAPI Path:** /fsm/v1/Attendance/actions/checkin

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Attendance/actions/checkin?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/attendance/actions/checkin?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| Check_In_Time | string |  |
| user | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Attendance/actions/checkin?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/check-in-user.html

### Check Out User

**Method:** POST
**LowCodeAPI Path:** /fsm/v1/Attendance/actions/checkout

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Attendance/actions/checkout?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/attendance/actions/checkout?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| Check_In_Time | string |  |
| user | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Attendance/actions/checkout?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/check-out-user.html

### List Companies

**Method:** GET
**LowCodeAPI Path:** /fsm/v1/Companies

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/companies?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| page | number |  |
| per_page | number |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/get-companies.html

### Get a Company

**Method:** GET
**LowCodeAPI Path:** /fsm/v1/Companies/<record_id>

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies/<record_id>?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/companies/record_id?record_id={record_id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| record_id | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies/<record_id>?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/get-a-company.html

### Create a Company

**Method:** POST
**LowCodeAPI Path:** /fsm/v1/Companies

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/companies?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| Company_Name | string |  |
| Currency | string |  |
| Exchange_Rate | string |  |
| GST_Treatment | string |  |
| Place_of_Supply | string |  |
| Tax_Authority | string |  |
| Tax_Exemption_Code | string |  |
| Tax_Name | string |  |
| Tax_Reg_Number | string |  |
| Taxable | boolean |  |
| VAT_Treatment | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/create-company.html

### Edit a Company

**Method:** PUT
**LowCodeAPI Path:** /fsm/v1/Companies/<record_id>

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies/<record_id>?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/companies/record_id?record_id={record_id}&api_token=YOUR_API_TOKEN

**Path Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| record_id | string |  |

**Example Request (New Format):**

```bash
curl -X PUT 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Companies/<record_id>?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/edit-company.html

### List Contacts

**Method:** GET
**LowCodeAPI Path:** /fsm/v1/Contacts

**New Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/Contacts?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/zohofsm/fsm/v1/contacts?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| page | number |  |
| per_page | number |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/zohofsm/fsm/v1/Contacts?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://www.zoho.com/fsm/developer/help/api/get-contacts.html


## Usage Examples

### Example 1: Basic API Request (New Format)

Making a simple GET request to retrieve resources:

```bash
# Get a list of resources - no path parameters needed
curl -X GET "https://api.lowcodeapi.com/zohofsm/endpoint?api_token=YOUR_API_TOKEN"
```

### Example 2: Request with Path Parameters (New Format)

Retrieving a specific resource using its ID:

```bash
# Get specific resource by ID - replace RESOURCE_ID with actual ID from previous response
curl -X GET "https://api.lowcodeapi.com/zohofsm/endpoint/{RESOURCE_ID}?api_token=YOUR_API_TOKEN"
# Note: RESOURCE_ID typically comes from a previous list request or from the provider dashboard
```

### Example 3: POST Request with Body (New Format)

Creating a new resource:

```bash
# Create a new resource
curl -X POST "https://api.lowcodeapi.com/zohofsm/endpoint?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"field": "value", "another_field": "another_value"}'
```

## Error Handling

LowCodeAPI returns standard HTTP status codes. Common errors:

| Status Code | Description |
|-------------|-------------|
| 200 | Success - Request completed successfully |
| 400 | Bad Request - Invalid parameters or request body |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Endpoint or resource doesn't exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error - Provider API error |

All error responses include error details:

```json
{
  "data": {
    "error": {
      "message": "Error description",
      "code": "ERROR_CODE"
    }
  }
}
```

## Complete Endpoint Reference

| Endpoint | Method | Category |
|----------|--------|----------|
| Get an Asset | GET | Asset |
| Create an Asset | POST | Asset |
| Edit an Asset | PUT | Asset |
| Check In User | POST | Attendance |
| Check Out User | POST | Attendance |
| List Companies | GET | Companies |
| Get a Company | GET | Companies |
| Create a Company | POST | Companies |
| Edit a Company | PUT | Companies |
| List Contacts | GET | Contacts |
| Get a Contact | GET | Contact |
| Create a Contact | POST | Contact |
| Edit a Contact | PUT | Contact |
| List Estimates | GET | Estimates |
| Get an Estimate | GET | Estimates |
| Create an Estimate | POST | Estimates |
| Add Parts to a Service of an Estimate | PUT | Estimates |
| List Estimate Transitions | GET | Estimates |
| Perform an Estimate Transition | PUT | Estimates |
| Upload a file to ZFS (Zoho File System) | POST | Files |
| Download a file | GET | Files |
| List Invoices | GET | Invoice  |
| Create Invoices | POST | Invoice  |
| Send Invoice | POST | Invoice  |
| List Notes | GET | Notes |
| Get a Note | GET | Notes |
| Create a Note | POST | Notes |
| Edit a Note | PUT | Notes |
| Add an Attachment | POST | Notes |
| Create a Notification | POST | Notification |
| Search Records | GET | Records |
| Get Related Records | GET | Records |
| Associate Records with Integrated Service | POST | Records |
| Download a record | GET | Records |
| List Requests | GET | Requests |
| Get a Request | GET | Requests |
| Create a Request | POST | Requests |
| List Scheduled Maintenances | GET | Scheduled Maintenance |
| Get a Scheduled Maintenance | GET | Scheduled Maintenance |
| Create a Scheduled Maintenance | POST | Scheduled Maintenance |
| Edit a Scheduled Maintenance | PUT | Scheduled Maintenance |
| Enable a Scheduled Maintenance | PUT | Scheduled Maintenance |
| Disable a Scheduled Maintenance | PUT | Scheduled Maintenance |
| List Service Appointments | GET | Service Appointment |
| Get a Service Appointment | GET | Service Appointment |
| Create a Service Appointment | POST | Service Appointment |
| Edit a Service Appointment | PUT | Service Appointment |
| Reschedule a Service Appointment | PUT | Service Appointment |
| List Service Appointment Transitions | GET | Service Appointment |
| Dispatch a Service Appointment | PUT | Service Appointment |
| Terminate a Service Appointment | PUT | Service Appointment |
| Complete Work for Service Appointment | PUT | Service Appointment |
| List Service Territories | GET | Service Territories |
| Get a Service Territory | GET | Service Territories |
| Search Service Territories | GET | Service Territories |
| List Services/Parts | GET | Services/Parts |
| Get a Service/Part | GET | Services/Parts |
| Create a Service/Part | POST | Services/Parts |
| Edit a Service/Part | PUT | Services/Parts |
| Get an User | GET | User |
| List Users | GET | Users  |
| Create a User | POST | Users  |
| Edit a User | PUT | Users  |
| List Profiles | GET | Users  |
| List Work Orders | GET | Work |
| Get a Work Order | GET | Work |
| Create a Work Order | POST | Work |
| Edit a Work Order | PUT | Work |
| List Work Order Transitions | GET | Work |
| Perform a Work Order Transition | PUT | Work |
| List Work Types | GET | Work Types |
| Get a Work Type | GET | Work Types |

## API Definition Endpoints

You can fetch the complete API specification for this provider:

**New Format (OpenAPI spec):**
```bash
curl 'https://backend.lowcodeapi.com/zohofsm/openapi'
```

**Old Format (API definition):**
```bash
curl 'https://backend.lowcodeapi.com/zohofsm/definition'
```

## Response Format

All responses are wrapped in a `data` key:

```json
{
  "data": {
    // Actual response from provider (object or array)
  }
}
```