The ServiceTitan connector lets your AI agent act in each user's ServiceTitan account. Each user signs in to ServiceTitan once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 29 tools.
- Tools
- 29
- What they doRead · write · destructive
- 19 · 9 · 119 read9 write1 destructive
- Users sign in with
- Service account
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the ServiceTitan connection
In AgentKit > Connections, create a ServiceTitan connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolservicetitan_appointment_assignments_listList technician assignments on job appointments in a ServiceTitan tenant, filtered by appointment, job, technician or appointment start date.Read-onlyList Appointment Assignments
List technician assignments on job appointments in a ServiceTitan tenant, filtered by appointment, job, technician or appointment start date. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each assignment has id, technicianId, technicianName, appointmentId, jobId, assignedOn and status. Use this to see who is assigned to what. Use servicetitan_appointments_list for appointment times.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which assignments to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse appointment_idsstring- Comma-separated appointment IDs to return assignments for. Example: 567890,567891
appointment_starts_beforestring- Return assignments whose appointment starts before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
appointment_starts_on_or_afterstring- Return assignments whose appointment starts on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of assignment IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
job_idinteger- Return assignments for this job. Example: 456789
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, CreatedOn, ModifiedOn. Example: -ModifiedOn
technician_idsstring- Comma-separated technician IDs to return assignments for. Example: 5001,5002
servicetitan_appointments_listList job appointments in a ServiceTitan tenant, filtered by job, customer, technician, status or start, created and modified dates.Read-onlyList Appointments
List job appointments in a ServiceTitan tenant, filtered by job, customer, technician, status or start, created and modified dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each appointment has id, jobId, appointmentNumber, start, end, arrival window, status and customerId. Use this to see the schedule. Use servicetitan_appointment_assignments_list for which technicians are assigned.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which appointments to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
customer_idinteger- Return appointments for this customer. Example: 123456
idsstring- Comma-separated list of appointment IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
job_idinteger- Return appointments for this job. Example: 456789
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn. Example: -ModifiedOn
starts_beforestring- Return appointments that start before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
starts_on_or_afterstring- Return appointments that start on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
statusstring- Return appointments with this status: Scheduled, Dispatched, Working, Hold, Done or Canceled. Example: Scheduledone of
ScheduledDispatchedWorkingHoldDoneCanceled technician_idinteger- Return appointments this technician is assigned to. Example: 5001
servicetitan_business_units_listList business units in a ServiceTitan tenant, optionally filtered by name or active status.Read-onlyList Business Units
List business units in a ServiceTitan tenant, optionally filtered by name or active status. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each business unit has id, name, officialName, email, phoneNumber, address and active. Use this to get the business_unit_id that servicetitan_job_create needs.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which business units to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of business unit IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return business units whose name contains this text (case-insensitive). Example: HVAC
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, Name, CreatedOn, ModifiedOn. Example: -ModifiedOn
servicetitan_campaigns_listList marketing campaigns in a ServiceTitan tenant, optionally filtered by name, phone number or active status.Read-onlyList Campaigns
List marketing campaigns in a ServiceTitan tenant, optionally filtered by name, phone number or active status. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each campaign has id, name, category, active and campaign phone numbers. Use this to get the campaign_id that servicetitan_job_create and servicetitan_lead_create need.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which campaigns to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse campaign_phone_numberstring- Return campaigns that use this phone number. Example: 5555550100
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of campaign IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return campaigns whose name contains this text (case-insensitive). Example: Google Ads
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, Name, CreatedOn, ModifiedOn. Example: -ModifiedOn
servicetitan_customer_contacts_listList the contact methods (phone, mobile, email, fax) saved on a ServiceTitan customer.Read-onlyList Customer Contacts
List the contact methods (phone, mobile, email, fax) saved on a ServiceTitan customer. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each contact has id, type, value, memo and phoneSettings. Use this to get a customer's phone number or email. Use servicetitan_customer_get for the customer's address and flags.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
customer_idstringrequired- ID of the customer. Example: 123456
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
servicetitan_customer_getGet one ServiceTitan customer by ID.Read-onlyGet Customer
Get one ServiceTitan customer by ID. Returns the customer's name, type (Residential or Commercial), bill-to address, balance, flags such as doNotService, tags, custom fields and created/modified dates. Use servicetitan_customers_list to search when you don't have the ID. Use servicetitan_customer_contacts_list for phone numbers and emails.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
customer_idstringrequired- ID of the customer. Get it from servicetitan_customers_list. Example: 123456
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
servicetitan_customers_listList customers in a ServiceTitan tenant, filtered by name, address, phone, active status or created/modified dates.Read-onlyList Customers
List customers in a ServiceTitan tenant, filtered by name, address, phone, active status or created/modified dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each customer has id, name, type, address, balance, doNotService, active and custom fields. Use this to find a customer ID. Use servicetitan_customer_get when you already have the ID.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which customers to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse citystring- Return customers in this city. Example: Austin
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of customer IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return customers with this name. Example: Jane Smith
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
phonestring- Return customers that have a contact with this phone number. Example: 5555551234
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn. Example: -ModifiedOn
statestring- Return customers in this state. Example: TX
streetstring- Return customers on this street. Example: 123 Main St
zipstring- Return customers with this zip or postal code. Example: 78701
servicetitan_invoices_listList invoices in a ServiceTitan tenant, filtered by customer, job, business unit, invoice date, due date, total or status.Read-onlyList Invoices
List invoices in a ServiceTitan tenant, filtered by customer, job, business unit, invoice date, due date, total or status. By default all invoices are returned regardless of status. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each invoice has id, referenceNumber, invoiceDate, dueDate, subTotal, salesTax, total, balance, customer, location, businessUnit, job and syncStatus. Use servicetitan_payments_list for payments received.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
active_statestring- Which invoices to return by active state: ActiveOnly, InactiveOnly or All. Example: Allone of
ActiveOnlyInactiveOnlyAll business_unit_idinteger- Return invoices for this business unit. Example: 789
customer_idinteger- Return invoices for this customer. Example: 123456
due_date_beforestring- Return invoices due before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
due_date_on_or_afterstring- Return invoices due on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of invoice IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
invoiced_on_beforestring- Return invoices dated before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
invoiced_on_or_afterstring- Return invoices dated on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
job_idinteger- Return invoices linked to this job. Example: 456789
job_numberstring- Return invoices linked to this job number. Example: 10045
modified_beforestring- Return invoices modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return invoices modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
numberstring- Return invoices with this reference number. Example: 10045
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
statusesarray- Transaction statuses to include: Pending, Posted or Exported. All statuses are included by default. Example: ["Posted"]
total_greaternumber- Return invoices with a total greater than or equal to this amount. Example: 100
total_lessnumber- Return invoices with a total less than or equal to this amount. Example: 5000
servicetitan_job_cancel_reasons_listList the job cancel reasons configured in a ServiceTitan tenant.Read-onlyList Job Cancel Reasons
List the job cancel reasons configured in a ServiceTitan tenant. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each reason has id, name and active. Use this to get the reason_id that servicetitan_job_cancel needs.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which cancel reasons to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: active and inactive reasons are both returned by default. Example: Anyone of
TrueAnyFalse include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn. Example: -ModifiedOn
servicetitan_job_getGet one ServiceTitan job by ID.Read-onlyGet Job
Get one ServiceTitan job by ID. Returns the job number, status, customer and location IDs, business unit, job type, priority, campaign, tags, appointment count, invoice ID, total and completion date. Use servicetitan_jobs_list to find jobs by customer, status or date. Use servicetitan_appointments_list with job_id for its appointments.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_idstringrequired- ID of the job. Get it from servicetitan_jobs_list. Example: 456789
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
servicetitan_job_notes_listList the notes on a ServiceTitan job.Read-onlyList Job Notes
List the notes on a ServiceTitan job. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each note has text, isPinned, createdById and createdOn. Use servicetitan_job_note_create to add a note.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_idstringrequired- ID of the job. Example: 456789
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
servicetitan_job_types_listList the job types configured in a ServiceTitan tenant, optionally filtered by name or priority.Read-onlyList Job Types
List the job types configured in a ServiceTitan tenant, optionally filtered by name or priority. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each job type has id, name, businessUnitIds, duration, priority, class and active. Use this to get the job_type_id that servicetitan_job_create and servicetitan_lead_create need.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which job types to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of job type IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return job types with this name. Example: AC Repair
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
prioritystring- Return job types with this priority. Example: Normal
servicetitan_jobs_listList jobs in a ServiceTitan tenant, filtered by status, customer, location, technician, job type, business unit or appointment, created, modified and completed dates.Read-onlyList Jobs
List jobs in a ServiceTitan tenant, filtered by status, customer, location, technician, job type, business unit or appointment, created, modified and completed dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each job has id, jobNumber, customerId, locationId, jobStatus, businessUnitId, jobTypeId, priority, campaignId, appointmentCount, total and completedOn. Use this to find jobs. Use servicetitan_job_get when you already have the job ID, and servicetitan_appointments_list for appointment times.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
appointment_starts_beforestring- Return jobs with any appointment starting before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
appointment_starts_on_or_afterstring- Return jobs with any appointment starting on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
business_unit_idinteger- Return jobs in this business unit. Example: 789
completed_beforestring- Return jobs completed before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
completed_on_or_afterstring- Return jobs completed on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
customer_idinteger- Return jobs for this customer. Example: 123456
idsstring- Comma-separated list of job IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
job_statusstring- Return jobs with this status: Scheduled, Dispatched, InProgress, Hold, Completed or Canceled. Example: Scheduledone of
ScheduledDispatchedInProgressHoldCompletedCanceled job_type_idinteger- Return jobs of this job type. Example: 321
location_idinteger- Return jobs at this location. Example: 234567
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
numberstring- Return the job with this job number. Example: 10045
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
prioritystring- Return jobs with this priority: Low, Normal, High or Urgent. Example: Highone of
LowNormalHighUrgent sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn, Priority. Example: -ModifiedOn
technician_idinteger- Return jobs where this technician is assigned to any appointment. Example: 5001
servicetitan_lead_getGet one ServiceTitan lead by ID.Read-onlyGet Lead
Get one ServiceTitan lead by ID. Returns the lead's status, customer and location IDs, campaign, business unit, job type, priority, summary, call reason and follow-up date. Use servicetitan_leads_list to find leads by status or customer.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
lead_idstringrequired- ID of the lead. Get it from servicetitan_leads_list. Example: 345678
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
servicetitan_leads_listList leads in a ServiceTitan tenant, filtered by status, customer, phone, name or created/modified dates.Read-onlyList Leads
List leads in a ServiceTitan tenant, filtered by status, customer, phone, name or created/modified dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each lead has id, status, customerId, locationId, campaignId, jobTypeId, priority, summary and followUpDate. Use this to review open leads. Use servicetitan_lead_get when you already have the ID.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
customer_idinteger- Return leads for this customer. Example: 123456
idsstring- Comma-separated list of lead IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
lead_customer_namestring- Return leads with this customer name. Example: Jane Smith
lead_phonestring- Return leads with this phone number. Example: 5555551234
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn. Example: -ModifiedOn
statusstring- Return leads with this status: Open, Dismissed or Converted. Example: Openone of
OpenDismissedConverted
servicetitan_location_getGet one ServiceTitan service location by ID.Read-onlyGet Location
Get one ServiceTitan service location by ID. Returns the location's name, customerId, address, tax zone, active state, tags and custom fields. Use servicetitan_locations_list to find a location by customer or address.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
location_idstringrequired- ID of the location. Get it from servicetitan_locations_list. Example: 234567
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
servicetitan_locations_listList service locations in a ServiceTitan tenant, filtered by customer, name, address or created/modified dates.Read-onlyList Locations
List service locations in a ServiceTitan tenant, filtered by customer, name, address or created/modified dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each location has id, customerId, name, address, active and custom fields. Use this to find the location ID a job needs. Use servicetitan_location_get when you already have the ID.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which locations to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse citystring- Return locations in this city. Example: Austin
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
customer_idinteger- Return only locations that belong to this customer. Example: 123456
idsstring- Comma-separated list of location IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return locations with this name. Example: Jane Smith - Home
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, ModifiedOn, CreatedOn. Example: -ModifiedOn
statestring- Return locations in this state. Example: TX
streetstring- Return locations on this street. Example: 123 Main St
zipstring- Return locations with this zip or postal code. Example: 78701
servicetitan_payments_listList payments in a ServiceTitan tenant, filtered by customer, invoice, paid date, total or created and modified dates.Read-onlyList Payments
List payments in a ServiceTitan tenant, filtered by customer, invoice, paid date, total or created and modified dates. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each payment has id, referenceNumber, date, type, total, unappliedAmount, customer and appliedTo invoices. Use servicetitan_invoices_list for invoice totals and balances.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
active_statestring- Which payments to return by active state: ActiveOnly, InactiveOnly or All (default ActiveOnly). Example: Allone of
ActiveOnlyInactiveOnlyAll applied_to_invoice_idsstring- Comma-separated invoice IDs; return payments applied to them. Example: 678901,678902
created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
customer_idinteger- Return payments from this customer. Example: 123456
idsstring- Comma-separated list of payment IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
paid_on_afterstring- Return payments paid on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
paid_on_beforestring- Return payments paid before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
total_greaternumber- Return payments with a total greater than or equal to this amount. Example: 100
total_lessnumber- Return payments with a total less than or equal to this amount. Example: 5000
servicetitan_technicians_listList technicians in a ServiceTitan tenant, optionally filtered by name or active status.Read-onlyList Technicians
List technicians in a ServiceTitan tenant, optionally filtered by name or active status. Returns page, pageSize, hasMore, totalCount (when requested) and a data array. Each technician has id, userId, name, businessUnitId, email, phoneNumber, team and active. Use this to get technician IDs for servicetitan_appointment_technicians_assign and job filters.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activestring- Which technicians to return by active status: True (active only), False (inactive only) or Any. ServiceTitan's default: only active records are returned by default. Example: Anyone of
TrueAnyFalse created_beforestring- Return records created before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
created_on_or_afterstring- Return records created on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
idsstring- Comma-separated list of technician IDs to look up (maximum 50). Example: 101,102,103
include_totalboolean- Set to true to include the total record count in the response (totalCount). Example: true
modified_beforestring- Return records modified before this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
modified_on_or_afterstring- Return records modified on or after this date/time (ISO 8601 date-time in UTC). Example: 2026-01-01T00:00:00Z
namestring- Return technicians whose name contains this text (case-insensitive). Example: Mike
pageinteger- Page number to return, starting from 1. Example: 2
page_sizeinteger- How many records to return per page (ServiceTitan's default is 50). Example: 100
sortstring- Sort order: +FieldName for ascending or -FieldName for descending. Available fields: Id, Name, CreatedOn, ModifiedOn. Example: -ModifiedOn
servicetitan_appointment_rescheduleMove a ServiceTitan job appointment to a new start and end time, and optionally a new arrival window.WriteReschedule Appointment
Move a ServiceTitan job appointment to a new start and end time, and optionally a new arrival window. Returns the updated appointment. Use servicetitan_appointments_list to find the appointment ID. Use servicetitan_appointment_technicians_assign to change who is assigned.
- Idempotent
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
appointment_idstringrequired- ID of the appointment. Get it from servicetitan_appointments_list. Example: 567890
endstringrequired- New end date/time in UTC (ISO 8601). Example: 2026-12-02T17:00:00Z
startstringrequired- New start date/time in UTC (ISO 8601). Example: 2026-12-02T15:00:00Z
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
arrival_window_endstring- New arrival window end in UTC, if arrival windows are configured. Example: 2026-12-02T16:00:00Z
arrival_window_startstring- New arrival window start in UTC, if arrival windows are configured. Example: 2026-12-02T14:00:00Z
servicetitan_appointment_technicians_assignAssign one or more technicians to a ServiceTitan job appointment.WriteAssign Technicians to Appointment
Assign one or more technicians to a ServiceTitan job appointment. Returns the appointment. Call servicetitan_appointment_assignments_list to see the assignments. Get technician IDs from servicetitan_technicians_list and appointment IDs from servicetitan_appointments_list.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_appointment_idintegerrequired- ID of the appointment to assign technicians to. Example: 567890
technician_idsarrayrequired- IDs of the technicians to assign. Example: [5001, 5002]
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
servicetitan_customer_createCreate a customer in ServiceTitan with a bill-to address and at least one service location.WriteCreate Customer
Create a customer in ServiceTitan with a bill-to address and at least one service location. Returns the new customer with its id, address, locations and contacts. Use servicetitan_customers_list first to avoid duplicates. Use servicetitan_customer_update to change an existing customer.
Inputs
addressobjectrequired- Bill-to address of the customer. Address as a JSON object with street, city, state, zip and country (all required) and optional unit, latitude and longitude. Example: {"street": "123 Main St", "unit": "Suite 4", "city": "Austin", "state": "TX", "zip": "78701", "country": "USA"}
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
namestringrequired- Customer's name, as a person or business name. Example: Jane Smith
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
contactsarray- Customer contact methods. Contact methods as a JSON array. Each item needs a type (Phone, MobilePhone, Email or Fax) and a value, plus an optional memo. Example: [{"type": "MobilePhone", "value": "5555551234", "memo": "Owner"}, {"type": "Email", "value": "jane@example.com"}]
do_not_mailboolean- Set to true to flag the customer as do not mail. Example: false
do_not_serviceboolean- Set to true to flag the customer as do not service. Example: false
locationsarray- Service locations for the customer as a JSON array. ServiceTitan requires at least one. Each location needs a name and an address object (street, city, state, zip, country), and can have contacts in the same shape as the customer contacts. If you leave this empty, the tool creates one location named after the customer at the bill-to address. Example: [{"name": "Jane Smith - Home", "address": {"street": "123 Main St", "city": "Austin", "state": "TX", "zip": "78701", "country": "USA"}}]
tag_type_idsarray- IDs of tag types to put on the customer. Example: [101, 102]
typestring- Customer type: Residential or Commercial. Example: Residentialone of
ResidentialCommercial
servicetitan_customer_note_createAdd a note to a ServiceTitan customer record, optionally pinned to the top or copied to the customer's active locations.WriteAdd Customer Note
Add a note to a ServiceTitan customer record, optionally pinned to the top or copied to the customer's active locations. Returns the new note with its text, pinned state and created date. Use servicetitan_job_note_create to note a specific job instead.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
customer_idstringrequired- ID of the customer. Example: 123456
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
textstringrequired- Text of the note. Example: Customer prefers morning appointments.
add_to_locationsboolean- Set to true to add the same note to all of the customer's active locations. Example: false
pin_to_topboolean- Set to true to pin the note to the top of the customer's notes. Example: true
servicetitan_customer_updateUpdate fields on an existing ServiceTitan customer.WriteUpdate Customer
Update fields on an existing ServiceTitan customer. Only the fields you send change. Returns the updated customer. Use servicetitan_customer_create for a new customer. To deactivate a customer, set active to false.
- Idempotent
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
customer_idstringrequired- ID of the customer. Get it from servicetitan_customers_list. Example: 123456
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
activeboolean- Set to false to deactivate the customer, or true to reactivate. Example: false
addressobject- New bill-to address. Send the full address. Address as a JSON object with street, city, state, zip and country (all required) and optional unit, latitude and longitude. Example: {"street": "123 Main St", "unit": "Suite 4", "city": "Austin", "state": "TX", "zip": "78701", "country": "USA"}
do_not_mailboolean- Flag the customer as do not mail (true) or clear the flag (false). Example: true
do_not_serviceboolean- Flag the customer as do not service (true) or clear the flag (false). Example: false
namestring- New customer name. Example: Jane Smith-Lee
tag_type_idsarray- Full list of tag type IDs for the customer. This replaces the customer's tags. Example: [101, 102]
typestring- New customer type: Residential or Commercial. Example: Commercialone of
ResidentialCommercial
servicetitan_job_createBook a new job in ServiceTitan for a customer location, with one or more appointments.WriteCreate Job
Book a new job in ServiceTitan for a customer location, with one or more appointments. Returns the new job with its id, jobNumber, jobStatus and firstAppointmentId. Use servicetitan_lead_create when the work isn't ready to schedule. Get the IDs this needs from servicetitan_customers_list, servicetitan_locations_list, servicetitan_business_units_list, servicetitan_job_types_list and servicetitan_campaigns_list.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
appointmentsarrayrequired- Appointments for the job as a JSON array; at least one is required. Each item needs start and end (ISO 8601 UTC) and can have arrivalWindowStart, arrivalWindowEnd and technicianIds. Example: [{"start": "2026-12-01T15:00:00Z", "end": "2026-12-01T17:00:00Z", "technicianIds": [5001]}]
business_unit_idintegerrequired- ID of the business unit doing the work. Get it from servicetitan_business_units_list. Example: 789
campaign_idintegerrequired- ID of the marketing campaign the job came from. Get it from servicetitan_campaigns_list. Example: 456
customer_idintegerrequired- ID of the job's customer. Example: 123456
job_type_idintegerrequired- ID of the job type. Get it from servicetitan_job_types_list. Example: 321
location_idintegerrequired- ID of the job's service location; it must belong to the customer. Example: 234567
prioritystringrequired- Job priority: Low, Normal, High or Urgent. Example: Normalone of
LowNormalHighUrgent tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
customer_postring- Customer purchase order number. Example: PO-7788
lead_idinteger- ID of the lead this job comes from. Example: 345678
no_chargeboolean- Set to true for a no-charge job. Example: false
project_idinteger- ID of the project to add the job to. Example: 9001
sold_by_idinteger- ID of the technician who sold the job. Example: 5001
summarystring- Job summary describing the work; HTML is allowed. Example: Replace capacitor on outdoor AC unit.
tag_type_idsarray- IDs of tag types to put on the job. Example: [101, 102]
servicetitan_job_note_createAdd a note to a ServiceTitan job, optionally pinned to the top.WriteAdd Job Note
Add a note to a ServiceTitan job, optionally pinned to the top. Returns the new note with its text, pinned state and created date. Use servicetitan_customer_note_create for a note on the customer record instead.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_idstringrequired- ID of the job. Example: 456789
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
textstringrequired- Text of the note. Example: Gate code is 4321.
pin_to_topboolean- Set to true to pin the note to the top of the job's notes. Example: true
servicetitan_job_updateUpdate fields on an existing ServiceTitan job, such as its summary, priority, job type, business unit or customer PO.WriteUpdate Job
Update fields on an existing ServiceTitan job, such as its summary, priority, job type, business unit or customer PO. Only the fields you send change. Returns the updated job. Use servicetitan_appointment_reschedule to move an appointment and servicetitan_job_cancel to cancel the job.
- Idempotent
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_idstringrequired- ID of the job. Example: 456789
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
business_unit_idinteger- New business unit ID. Example: 789
campaign_idinteger- New campaign ID. Example: 456
customer_postring- New customer purchase order number. Example: PO-7789
job_type_idinteger- New job type ID. Example: 321
no_chargeboolean- Set to true to make it a no-charge job, false to clear. Example: true
prioritystring- New priority: Low, Normal, High or Urgent. Example: Urgentone of
LowNormalHighUrgent sold_by_idinteger- ID of the technician who sold the job. Example: 5001
summarystring- New job summary; HTML is allowed. Example: Replace capacitor and clean coils.
tag_type_idsarray- Full list of tag type IDs for the job. This replaces the job's tags: tags you leave out are removed. Example: [101, 102]
servicetitan_lead_createCreate a follow-up lead in ServiceTitan for an existing customer or for a prospect with contact details.WriteCreate Lead
Create a follow-up lead in ServiceTitan for an existing customer or for a prospect with contact details. Returns the new lead with its id and status. Use servicetitan_job_create instead when the work is ready to schedule. Get campaign IDs from servicetitan_campaigns_list.
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
campaign_idintegerrequired- ID of the marketing campaign the lead came from. Get it from servicetitan_campaigns_list. Example: 456
summarystringrequired- Summary of what the lead needs. Example: AC not cooling, wants a quote for a new unit.
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
business_unit_idinteger- ID of the business unit. Get it from servicetitan_business_units_list. Example: 789
call_reason_idinteger- ID of the call reason. Required when follow_up_date is empty. Example: 12
customer_idinteger- ID of an existing customer for the lead. Example: 123456
follow_up_datestring- When to follow up, as an ISO 8601 date-time in UTC. Required when call_reason_id is empty. Example: 2026-12-01T15:00:00Z
job_type_idinteger- ID of the job type the lead is for. Get it from servicetitan_job_types_list. Example: 321
lead_citystring- Prospect's city. Example: Austin
lead_countrystring- Prospect's country. Example: USA
lead_customer_namestring- Prospect's name, when the lead has no customer record yet. Example: John Doe
lead_emailstring- Prospect's email address. Example: john@example.com
lead_phonestring- Prospect's phone number. Example: 5555559876
lead_statestring- Prospect's state. Example: TX
lead_streetstring- Prospect's street address. Example: 456 Oak Ave
lead_zipstring- Prospect's zip or postal code. Example: 78702
location_idinteger- ID of an existing location for the lead. Example: 234567
prioritystring- Lead priority: Low, Normal, High or Urgent. Example: Highone of
LowNormalHighUrgent tag_type_idsarray- IDs of tag types to put on the lead. Example: [101, 102]
servicetitan_job_cancelCancel a ServiceTitan job with a cancel reason and memo.DestructiveCancel Job
Cancel a ServiceTitan job with a cancel reason and memo. Returns an empty response on success. Get valid reason IDs from servicetitan_job_cancel_reasons_list first. Use servicetitan_job_update to change a job without canceling it.
- Idempotent
Inputs
app_keystringrequired- App Key of your ServiceTitan developer app, sent as the ST-App-Key header on every call. Find it in the ServiceTitan Developer Portal (developer.servicetitan.io) under My Apps > your app > Keys > Application Key. It belongs to the same app whose Client ID and Client Secret this connection uses. Example: ak1.abcd1234efgh5678ijkl
job_idstringrequired- ID of the job. Example: 456789
memostringrequired- Memo explaining the cancellation. Example: Customer fixed the issue themselves.
reason_idintegerrequired- ID of the job cancel reason. Get it from servicetitan_job_cancel_reasons_list. Example: 3
tenant_idstringrequired- Your ServiceTitan tenant ID (a number). An admin finds it in ServiceTitan under Settings > Integrations > API Application Access, next to the connected app. Example: 1234567890
No tools match.