locations_create
Create and manage locations within ServiceTitan by defining address details, contacts, custom fields, and external data. Integrates with the MCP server for streamlined API interaction.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
active | No | Location Active | |
address | No | Address Details | |
contacts | No | Contacts | |
customFields | No | Custom Fields | |
customerId | No | Customer ID | |
externalData | No | External Data | |
name | No | Location Name | |
tagTypeIds | No | Tag Type IDs | |
taxZoneId | No | Tax Zone ID | |
tenant | Yes | Format - int64. Tenant ID | |
zoneId | No | Zone ID |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"active": {
"default": true,
"description": "Location Active",
"type": "boolean"
},
"address": {
"additionalProperties": false,
"description": "Address Details",
"properties": {
"city": {
"description": "City",
"type": "string"
},
"country": {
"description": "Country",
"type": "string"
},
"latitude": {
"description": "Latitude",
"type": "number"
},
"longitude": {
"description": "Longitude",
"type": "number"
},
"state": {
"description": "State",
"type": "string"
},
"street": {
"description": "Street Address",
"type": "string"
},
"unit": {
"description": "Unit Number",
"type": "string"
},
"zip": {
"description": "Zip Code",
"type": "string"
}
},
"type": "object"
},
"contacts": {
"description": "Contacts",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Contact ID",
"type": "integer"
},
"memo": {
"description": "Contact Memo",
"type": "string"
},
"type": {
"description": "Contact Type - any object"
},
"value": {
"description": "Contact Value",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"customFields": {
"description": "Custom Fields",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Custom Field Name",
"type": "string"
},
"typeId": {
"description": "Custom Field Type ID",
"type": "integer"
},
"value": {
"description": "Custom Field Value",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"customerId": {
"description": "Customer ID",
"type": "integer"
},
"externalData": {
"description": "External Data",
"items": {
"additionalProperties": false,
"properties": {
"key": {
"description": "External Data Key",
"type": "string"
},
"value": {
"description": "External Data Value",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"name": {
"description": "Location Name",
"type": "string"
},
"tagTypeIds": {
"description": "Tag Type IDs",
"items": {
"type": "integer"
},
"type": "array"
},
"taxZoneId": {
"description": "Tax Zone ID",
"type": "integer"
},
"tenant": {
"description": "Format - int64. Tenant ID",
"type": "integer"
},
"zoneId": {
"description": "Zone ID",
"type": "integer"
}
},
"required": [
"tenant"
],
"type": "object"
}