NonJobAppointments_Create
Create and manage non-job appointments for technicians in ServiceTitan. Specify details like start time, duration, and visibility on schedules to optimize technician planning and dispatch.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| active | No | Active appointment | |
| allDay | No | All day appointment | |
| clearDispatchBoard | No | Clear dispatch board | |
| clearTechnicianView | No | Clear technician view | |
| countOccurrences | No | Count occurrences | |
| daysOfWeek | No | Days of week (e.g., Mon,Tue) | |
| duration | Yes | Appointment duration | |
| endOn | No | End date | |
| endType | No | End type (e.g., on, after) | |
| frequency | No | Frequency (e.g., daily, weekly) | |
| interval | No | Interval | |
| name | Yes | Appointment name | |
| removeTechnicianFromCapacityPlanning | No | Remove technician from capacity planning | |
| repeat | No | Repeat appointment | |
| showOnTechnicianSchedule | No | Show on technician schedule | |
| start | Yes | Start date/time | |
| summary | No | Appointment summary | |
| technicianId | Yes | Technician ID | |
| tenant | Yes | Tenant ID | |
| timesheetCodeId | Yes | Timesheet code ID |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"active": {
"default": true,
"description": "Active appointment",
"type": "boolean"
},
"allDay": {
"default": true,
"description": "All day appointment",
"type": "boolean"
},
"clearDispatchBoard": {
"default": true,
"description": "Clear dispatch board",
"type": "boolean"
},
"clearTechnicianView": {
"default": true,
"description": "Clear technician view",
"type": "boolean"
},
"countOccurrences": {
"default": 0,
"description": "Count occurrences",
"type": "integer"
},
"daysOfWeek": {
"description": "Days of week (e.g., Mon,Tue)",
"type": "string"
},
"duration": {
"description": "Appointment duration",
"type": "string"
},
"endOn": {
"description": "End date",
"type": "string"
},
"endType": {
"description": "End type (e.g., on, after)",
"type": "string"
},
"frequency": {
"description": "Frequency (e.g., daily, weekly)",
"type": "string"
},
"interval": {
"default": 0,
"description": "Interval",
"type": "integer"
},
"name": {
"description": "Appointment name",
"type": "string"
},
"removeTechnicianFromCapacityPlanning": {
"default": true,
"description": "Remove technician from capacity planning",
"type": "boolean"
},
"repeat": {
"default": false,
"description": "Repeat appointment",
"type": "boolean"
},
"showOnTechnicianSchedule": {
"default": true,
"description": "Show on technician schedule",
"type": "boolean"
},
"start": {
"description": "Start date/time",
"type": "string"
},
"summary": {
"description": "Appointment summary",
"type": "string"
},
"technicianId": {
"description": "Technician ID",
"type": "integer"
},
"tenant": {
"description": "Tenant ID",
"type": "integer"
},
"timesheetCodeId": {
"description": "Timesheet code ID",
"type": "integer"
}
},
"required": [
"tenant",
"technicianId",
"start",
"name",
"duration",
"timesheetCodeId"
],
"type": "object"
}