tasks_create
Create and manage tasks within ServiceTitan by specifying tenant, assigned personnel, status, priority, and related details. Assign tasks, set deadlines, and track completions for efficient task management.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignedToId | No | ID of the person the task is assigned to | |
| businessUnitId | No | Business unit ID | |
| completeBy | No | Date the task should be completed by | |
| createdOn | No | Date the task was created | |
| customerId | No | Customer ID | |
| customerName | No | Customer name | |
| description | No | Description of the task | |
| descriptionModifiedBy | No | User who modified the description | |
| descriptionModifiedOn | No | Date the description was last modified | |
| employeeTaskResolutionId | No | Employee task resolution ID | |
| employeeTaskSourceId | No | Employee task source ID | |
| employeeTaskTypeId | No | Employee task type ID | |
| involvedEmployeeIdList | No | List of involved employee IDs | |
| isClosed | No | Whether the task is closed | |
| jobId | No | Job ID | |
| jobNumber | No | Job number | |
| modifiedOn | No | Date the task was last modified | |
| name | Yes | Name of the task | |
| priority | No | Priority of the task | |
| projectId | No | Project ID | |
| refundIssued | No | Refund issued amount | |
| reportedById | No | ID of the person who reported the task | |
| reportedDate | No | Date the task was reported | |
| startedOn | No | Date the task was started on | |
| status | No | Status of the task | |
| tenant | Yes | Format - int64. Tenant ID |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assignedToId": {
"description": "ID of the person the task is assigned to",
"type": "integer"
},
"businessUnitId": {
"description": "Business unit ID",
"type": "integer"
},
"completeBy": {
"description": "Date the task should be completed by",
"type": "string"
},
"createdOn": {
"description": "Date the task was created",
"type": "string"
},
"customerId": {
"description": "Customer ID",
"type": "integer"
},
"customerName": {
"description": "Customer name",
"type": "string"
},
"description": {
"description": "Description of the task",
"type": "string"
},
"descriptionModifiedBy": {
"description": "User who modified the description",
"type": "string"
},
"descriptionModifiedOn": {
"description": "Date the description was last modified",
"type": "string"
},
"employeeTaskResolutionId": {
"description": "Employee task resolution ID",
"type": "integer"
},
"employeeTaskSourceId": {
"description": "Employee task source ID",
"type": "integer"
},
"employeeTaskTypeId": {
"description": "Employee task type ID",
"type": "integer"
},
"involvedEmployeeIdList": {
"description": "List of involved employee IDs",
"items": {
"type": "integer"
},
"type": "array"
},
"isClosed": {
"description": "Whether the task is closed",
"type": "boolean"
},
"jobId": {
"description": "Job ID",
"type": "integer"
},
"jobNumber": {
"description": "Job number",
"type": "string"
},
"modifiedOn": {
"description": "Date the task was last modified",
"type": "string"
},
"name": {
"description": "Name of the task",
"type": "string"
},
"priority": {
"description": "Priority of the task",
"type": "string"
},
"projectId": {
"description": "Project ID",
"type": "integer"
},
"refundIssued": {
"description": "Refund issued amount",
"type": "number"
},
"reportedById": {
"description": "ID of the person who reported the task",
"type": "integer"
},
"reportedDate": {
"description": "Date the task was reported",
"type": "string"
},
"startedOn": {
"description": "Date the task was started on",
"type": "string"
},
"status": {
"description": "Status of the task",
"type": "string"
},
"tenant": {
"description": "Format - int64. Tenant ID",
"type": "integer"
}
},
"required": [
"tenant",
"name"
],
"type": "object"
}