> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Create Appointment

- Component: `appmixer.zoho.crm.CreateAppointment`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.zoho.crm 2.4.5](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateAppointment>

Schedules an appointment in Zoho CRM for a contact, a service and a service member. Requires the Services module to be enabled in the Zoho CRM organization.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Appointment Name (`appointmentName`) | text | The name of the appointment, e.g. "James - AC Repair". |
| Appointment For (`appointmentForId`) | text | The customer the appointment is scheduled for. The list offers contacts; for a custom customer module, set Appointment For Module and enter the record ID. |
| Appointment For Module (`appointmentForModule`) | text | The API name of the module the customer record belongs to. Contacts unless the organization uses a custom customer module. |
| Service ID (`serviceId`) | text | The ID of the service (Services module) the appointment is for. |
| Owner (`ownerId`) | text | The user who delivers the service. They must be a member of the selected service. |
| Start Time (`startTime`) | date-time | When the appointment starts. It must lie in the future and inside the availability of the service. Zoho computes the end time from the duration of the service. |
| Location (`location`) | select | Where the service is delivered. The value must be one of the locations allowed on the service. |
| Address (`address`) | text | The address of the customer. Required when the location is Client Address. |
| Additional Information (`additionalInformation`) | textarea | Free-text notes stored on the appointment. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| ID (`id`) | string | - |
| Appointment Name (`Appointment_Name`) | string | - |
| Start Time (`Appointment_Start_Time`) | string | - |
| End Time (`Appointment_End_Time`) | string | - |
| Duration (minutes) (`Duration`) | integer | - |
| `Status` | string | - |
| Appointment For (`Appointment_For`) | object | - |
| Service (`Service_Name`) | object | - |
| `Location` | string | - |
| `Address` | string | - |
| Additional Information (`Additional_Information`) | string | - |
| `Owner` | object | - |
| Created Time (`Created_Time`) | string | - |
| Modified Time (`Modified_Time`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.zoho.crm.CreateAppointment",
  "label": "Create Appointment",
  "description": "Schedules an appointment in Zoho CRM for a contact, a service and a service member. Requires the Services module to be enabled in the Zoho CRM organization.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:zoho"
  },
  "quota": {
    "manager": "appmixer:zoho",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "appointmentName": {
            "type": "string"
          },
          "appointmentForId": {
            "type": "string"
          },
          "appointmentForModule": {
            "type": "string"
          },
          "serviceId": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "startTime": {
            "type": "string"
          },
          "location": {
            "type": "string",
            "enum": [
              "Business Address",
              "Client Address"
            ]
          },
          "address": {
            "type": "string"
          },
          "additionalInformation": {
            "type": "string"
          }
        },
        "required": [
          "appointmentName",
          "appointmentForId",
          "serviceId",
          "ownerId",
          "startTime",
          "location"
        ]
      },
      "inspector": {
        "inputs": {
          "appointmentName": {
            "type": "text",
            "label": "Appointment Name",
            "index": 1,
            "tooltip": "The name of the appointment, e.g. \"James - AC Repair\"."
          },
          "appointmentForId": {
            "type": "text",
            "label": "Appointment For",
            "index": 2,
            "tooltip": "The customer the appointment is scheduled for. The list offers contacts; for a custom customer module, set Appointment For Module and enter the record ID.",
            "source": {
              "url": "/component/appmixer/zoho/crm/ListRecords?outPort=out",
              "data": {
                "transform": "./transformers#personsToSelectArray",
                "messages": {
                  "in": {
                    "allAtOnce": true,
                    "moduleName": "Contacts"
                  }
                }
              }
            }
          },
          "appointmentForModule": {
            "type": "text",
            "label": "Appointment For Module",
            "index": 3,
            "defaultValue": "Contacts",
            "tooltip": "The API name of the module the customer record belongs to. Contacts unless the organization uses a custom customer module."
          },
          "serviceId": {
            "type": "text",
            "label": "Service ID",
            "index": 4,
            "tooltip": "The ID of the service (Services module) the appointment is for."
          },
          "ownerId": {
            "type": "text",
            "label": "Owner",
            "index": 5,
            "tooltip": "The user who delivers the service. They must be a member of the selected service.",
            "source": {
              "url": "/component/appmixer/zoho/crm/ListUsers?outPort=users",
              "data": {
                "transform": "./ListUsers#usersToSelectArray"
              }
            }
          },
          "startTime": {
            "type": "date-time",
            "label": "Start Time",
            "index": 6,
            "tooltip": "When the appointment starts. It must lie in the future and inside the availability of the service. Zoho computes the end time from the duration of the service."
          },
          "location": {
            "type": "select",
            "label": "Location",
            "index": 7,
            "defaultValue": "Business Address",
            "tooltip": "Where the service is delivered. The value must be one of the locations allowed on the service.",
            "options": [
              {
                "label": "Business Address",
                "value": "Business Address"
              },
              {
                "label": "Client Address",
                "value": "Client Address"
              }
            ]
          },
          "address": {
            "type": "text",
            "label": "Address",
            "index": 8,
            "tooltip": "The address of the customer. Required when the location is Client Address."
          },
          "additionalInformation": {
            "type": "textarea",
            "label": "Additional Information",
            "index": 9,
            "tooltip": "Free-text notes stored on the appointment."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "ID",
            "example": "4876876000000579001"
          },
          "Appointment_Name": {
            "type": "string",
            "title": "Appointment Name",
            "example": "Annual service visit"
          },
          "Appointment_Start_Time": {
            "type": "string",
            "title": "Start Time",
            "example": "2026-09-14T10:00:00+00:00"
          },
          "Appointment_End_Time": {
            "type": "string",
            "title": "End Time",
            "example": "2026-09-14T10:30:00+00:00"
          },
          "Duration": {
            "type": "integer",
            "title": "Duration (minutes)",
            "example": 30
          },
          "Status": {
            "type": "string",
            "title": "Status",
            "example": "Scheduled"
          },
          "Appointment_For": {
            "type": "object",
            "title": "Appointment For",
            "properties": {
              "id": {
                "type": "string",
                "title": "Appointment For.ID",
                "example": "4876876000000412001"
              },
              "name": {
                "type": "string",
                "title": "Appointment For.Name",
                "example": "Jane Doe"
              }
            }
          },
          "Service_Name": {
            "type": "object",
            "title": "Service",
            "properties": {
              "id": {
                "type": "string",
                "title": "Service.ID",
                "example": "4876876000000491001"
              },
              "name": {
                "type": "string",
                "title": "Service.Name",
                "example": "Onsite inspection"
              }
            }
          },
          "Location": {
            "type": "string",
            "title": "Location",
            "example": "Client Address"
          },
          "Address": {
            "type": "string",
            "title": "Address",
            "example": "221B Baker Street, London"
          },
          "Additional_Information": {
            "type": "string",
            "title": "Additional Information",
            "example": "Bring the replacement filter."
          },
          "Owner": {
            "type": "object",
            "title": "Owner",
            "properties": {
              "id": {
                "type": "string",
                "title": "Owner.ID",
                "example": "4876876000000306001"
              },
              "name": {
                "type": "string",
                "title": "Owner.Name",
                "example": "John Smith"
              },
              "email": {
                "type": "string",
                "title": "Owner.Email",
                "example": "john@example.com"
              }
            }
          },
          "Created_Time": {
            "type": "string",
            "title": "Created Time",
            "example": "2026-09-01T09:12:44+00:00"
          },
          "Modified_Time": {
            "type": "string",
            "title": "Modified Time",
            "example": "2026-09-02T14:03:19+00:00"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
