Skip to main content

ServiceTitan Connector

ServiceTitan ServiceTitan is a comprehensive field service management solution that helps businesses manage their operations, workforce, and customer service.

Connections

OAuth 2.0

Connect to Service Titan using OAuth 2.0

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

InputCommentsDefault
Token URLThe OAuth 2.0 Token URL for the API
Client IDClient Identifier of your app for the API
Client SecretClient Secret of your app for the API
TenantThe client tenant.
Application KeyThe ID of the payment.
EnvironmentThe environment to connect to

Actions

Assign Technician to Appointment

Assigns the list of technicians to the appointment

InputCommentsDefault
Connection
Job Appointment IDID of the job appointment
Technician IDsAssign these technicians to the appointment.
Debug RequestEnabling this flag will log out the current request.false

Cancel Job

Cancels a Job

InputCommentsDefault
Connection
Job IDThe job ID.
Reason IDID of job cancel reason
Job MemoMemo of job cancel reason
Debug RequestEnabling this flag will log out the current request.false

Create Appointment

Adds a new appointment to an existing job

InputCommentsDefault
Connection
Job IDThe job ID.
StartStart date/time (in UTC)
EndEnd date/time (in UTC)
Arrival Window StartArrival window start date/time (in UTC)
Arrival Window EndArrival window end date/time (in UTC)
Technician IDThe ID of the technician.
Special InstructionsSpecial instructions associated to the appointment
Debug RequestEnabling this flag will log out the current request.false

Create Booking by Provider

Create a booking

InputCommentsDefault
Connection
Booking ProviderThe ID of the booking provider.
SummarySummary of the booking
Is First Time ClientTrue if first time client
External IDExternal ID of booking
SourceThe source of the booking provider
NameBooking name
AddressAddress of the booking
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
ContactsContacts for the booking
[
{
"type": "Phone",
"value": "string",
"memo": "string"
}
]
Customer TypeType of the customer
StartStart date/time (in UTC)
Campaign IDID of the booking's campaign
Business Unit IDID of the booking's business unit
Job Type IDID of the booking's job type
PriorityBooking priority
Uploaded ImagesUploaded images
Send Confirmation EmailTrue if first time client
Debug RequestEnabling this flag will log out the current request.false

Create Customer

Create a New Customer

InputCommentsDefault
Connection
NameName of the customer
LocationLocations for the customer
[
{
"name": "string",
"address": {
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string",
"latitude": 0,
"longitude": 0
},
"contacts": [
{
"type": {},
"value": "string",
"memo": "string"
}
],
"customFields": [
{
"typeId": 0,
"value": "string"
}
],
"tagTypeIds": [
0
],
"externalData": {
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
}
]
AddressBill-To address of the customer record
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Customer TypeType of the customer
Do Not MailCustomer has been flagged as “do not mail”
Do Not ServiceCustomer has been flagged as “do not service”
ContactsContacts for the booking
[
{
"type": "Phone",
"value": "string",
"memo": "string"
}
]
Custom FieldsCustom fields for the request
[
{
"typeId": 0,
"value": "string"
}
]
Tag Type IDsA list of tags ID's
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Debug RequestEnabling this flag will log out the current request.false

Create Customer Contact

Create a contact for a customer

InputCommentsDefault
Connection
Customer IDThe customer ID.
Customer Contact TypeType of the customer contact
Customer Contact Type ValueThe email, phone number, or fax number for the contact
MemoShort description about this contact, for example, “work #” or “Owner’s daughter - Kelly”
Debug RequestEnabling this flag will log out the current request.false

Create Installed Equipment

Create a new Installed equipment

InputCommentsDefault
Connection
Location IDThe location id of the installed equipment
NameThe name of the installed equipment
Installed OnThe date the equipment was installed
Serial NumberSerial number of the installed equipment
MemoThe memo of the installed equipment
ManufacturerManufacturer of the installed equipment
ModelModel of the installed equipment
CostCost of the installed equipment
Manufacturer Warranty StartManufacturer warranty start date
Manufacturer Warranty EndManufacturer warranty end date
Service Provider Warranty StartService Provider Warranty Start date
Service Provider Warranty EndService Provider Warranty End date
Custom FieldsThe custom fields of the installed equipment
[
{
"typeId": 0,
"value": "string"
}
]
AttachmentsList of attachments
[
{
"alias": "string",
"fileName": "string",
"type": {},
"url": "string"
}
]
Tag Type IDsA list of tags ID's
Debug RequestEnabling this flag will log out the current request.false

Create Installed Equipment Attachment

Create a new installed equipment attachment

InputCommentsDefault
Connection
Attachment FileReference a file from another action. Must be a file type.
File NameName of the file
Debug RequestEnabling this flag will log out the current request.false

Create Invoices

Create adjustment invoice

InputCommentsDefault
Connection
Adjustment To IDThe ID of the invoice the adjustment is for.
NumberThe invoice number.
Type IDThe ID of the type of the payment.
Invoiced OnThe date the invoice was invoiced on.
SubtotalThe subtotal of the invoice.
TaxThe tax of the invoice.
SummaryThe summary of the invoice.
Royalty StatusThe royalty status of the invoice.
Royalty DateThe royalty date of the invoice.
Royalty Sent OnThe royalty sent date of the invoice.
Royalty MemoThe royalty sent date of the invoice.
Export IDGets or sets the identifier when exported.
Review StatusThe review status of the invoice.
Assigned To IDThe ID of the user the invoice is assigned to.
ItemsThe items of the invoice.
[
{
"skuId": 0,
"skuName": "string",
"technicianId": 0,
"description": "string",
"quantity": 0,
"unitPrice": 0,
"cost": 0,
"isAddOn": true,
"signature": "string",
"technicianAcknowledgementSignature": "string",
"installedOn": "string",
"inventoryWarehouseName": "string",
"skipUpdatingMembershipPrices": true,
"itemGroupName": "string",
"itemGroupRootId": 0,
"inventoryLocationId": 0,
"durationBillingId": 0,
"id": 0
}
]
Debug RequestEnabling this flag will log out the current request.false

Create Job

Create a job

InputCommentsDefault
Connection
Customer IDThe customer ID.
Location IDThe ID of the location.
Business Unit IDID of the job's business unit
Job Type IDID of the job's type
PriorityPriority of the job
Campaign IDID of the job's campaign
AppointmentsList of appointment information
[
{
"start": "string",
"end": "string",
"arrivalWindowStart": "string",
"arrivalWindowEnd": "string",
"technicianIds": [
0
]
}
]
Job Generated Lead SourceObject that contains: JobId: ID of the job from which this job was generated EmployeeId: ID of the office user or technician
{
"jobId": 0,
"employeeId": 0
}
Project IDID of the job's project
SummaryJob summary
Custom FieldsCustom fields for the job
[
{
"typeId": 0,
"value": "string"
}
]
Tag Type IDsTag type IDs for the job
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Invoice Signature Is RequiredOptional model that informs if invoice should requires a signature or not if not informed will follow the rules for location and job type
Customer POCustomer PO
Debug RequestEnabling this flag will log out the current request.false

Create Location

Creates a new location

InputCommentsDefault
Connection
NameThe name of the location
AddressThe address of the location
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Customer IDThe customer ID.
ContactsThe contacts associated with the location
[
{
"type": "Phone",
"value": "string",
"memo": "string"
}
]
Custom FieldsCustom fields for the request
[
{
"typeId": 0,
"value": "string"
}
]
Tag Type IDsA list of tags ID's
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Debug RequestEnabling this flag will log out the current request.false

Create Payment

Create a payment in Service Titan

InputCommentsDefault
Connection
Type IDThe ID of the type of the payment.
SplitsThe splits of the payment.
[
{
"invoiceId": 0,
"amount": 0
}
]
MemoThe memo of the payment.
Paid OnThe date the payment was paid on.
Auth CodeThe authorization code for the payment.
Check NumberThe check number for the payment.
Export IDGets or sets the identifier when exported.
StatusThe status of the payment.
Debug RequestEnabling this flag will log out the current request.false

Create Project

Create a new project

InputCommentsDefault
Connection
Location IDThe ID of the location.
Customer IDID of the project's customer
Project Manager IDsIDs of the project's managers
NameName of the project
SummarySummary of the project
Status IDProject status id
Sub Status IDProject sub status id
StartStart date of the project
Target Completion DateTarget completion date of the project
Actual Completion DateActual completion date of the project
Custom FieldsCustom fields for the project
[
{
"typeId": 0,
"value": "string"
}
]
External DataOptional model that contains a list of external data items that should be attached to this project.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Debug RequestEnabling this flag will log out the current request.false

Create Technician

Create new technician

InputCommentsDefault
Connection
NameThe name of the technician
Account Creation MethodAccount creation method
Role IDUser role Id
PositionsList of company positions
License TypeLicense type
Phone NumberTechnician's phone number
EmailTechnician's email address
Login UsernameTechnician's username
PasswordTechnician's password
Business Unit IDThe ID of the business unit to which the technician will be assigned
Azure Active Directory User IdAzure Active Directory User Id
TeamTeam name
Daily GoalDaily revenue goal
Burden RateBurden rate (hourly)
BiographyBiography of the technician
MemoMemo for the technician
Job FilterUpcoming appointment visibility
Job History Date FilterAppointment history visibility
AddressThe home address of the technician
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Custom FieldsCustom fields for the technician
[
{
"typeId": 0,
"value": "string"
}
]
Debug RequestEnabling this flag will log out the current request.false

Delete Appointment

Delete appointment by ID

InputCommentsDefault
Connection
Appointment IDThe ID of the appointment.
Debug RequestEnabling this flag will log out the current request.false

Delete Customer Contact

Removes a contact from a customer

InputCommentsDefault
Connection
Customer IDThe customer ID.
Customer Contact IDThe customer contact ID.
Debug RequestEnabling this flag will log out the current request.false

Delete Invoice Item

Delete an invoice item

InputCommentsDefault
Connection
Invoice IDThe ID of the invoice.
Item IDThe ID of the item.
Debug RequestEnabling this flag will log out the current request.false

Get Appointment

Retrieve an appointment by ID

InputCommentsDefault
Connection
Appointment IDThe ID of the appointment.
Debug RequestEnabling this flag will log out the current request.false

Get Booking by Provider

Retrieve a booking by ID

InputCommentsDefault
Connection
Booking ProviderThe ID of the booking provider.
Booking IDThe ID of the booking.
Debug RequestEnabling this flag will log out the current request.false

Get Booking by Tenant

Retrieve a booking by ID

InputCommentsDefault
Connection
Booking IDThe ID of the booking.
Debug RequestEnabling this flag will log out the current request.false

Get Customer

Retrieve a Customer by ID

InputCommentsDefault
Connection
Customer IDThe customer ID.
Debug RequestEnabling this flag will log out the current request.false

Get Installed Equipment

Retrieve a Installed Equipment by ID

InputCommentsDefault
Connection
Installed Equipment IDID of the installed equipment
Debug RequestEnabling this flag will log out the current request.false

Get Job

Retrieve a job by ID

InputCommentsDefault
Connection
Job IDThe job ID.
External Data Application GuidFormat - guid. If this guid is provided, external data corresponding to this application guid will be returned.
Debug RequestEnabling this flag will log out the current request.false

Get Location

Retrieve a location by ID

InputCommentsDefault
Connection
Location IDThe ID of the location to retrieve
Debug RequestEnabling this flag will log out the current request.false

Get Project

Retrieve a project by ID

InputCommentsDefault
Connection
Project IDThe ID of the project to retrieve
Debug RequestEnabling this flag will log out the current request.false

Get Technician

Retrieve a Technician by ID

InputCommentsDefault
Connection
Technician IDThe ID of the Technician to retrieve
Debug RequestEnabling this flag will log out the current request.false

List Appointment Assignment

Retrieve a list of appointment assignments

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Appointments

Retrieve a list of appointments

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Bookings by Provider

Retrieves a list of bookings

InputCommentsDefault
Connection
Booking ProviderThe ID of the booking provider.
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Bookings by Tenant

Retrieves a list of bookings

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Business Units

Gets a list of business units

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Customer Contacts

Gets a list of contacts for the specified customer

InputCommentsDefault
Connection
Customer IDThe customer ID.
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
Modified BeforeReturn items modified before certain date/time (in UTC)
Modified On Or AfterReturn items modified on or after certain date/time (in UTC)
Debug RequestEnabling this flag will log out the current request.false

List Customers

Retrieve a list of Customers

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Installed Equipment

Retrieve a list of installed equipment

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Installed Equipment Attachments

Retrieve installed Equipment attachments

InputCommentsDefault
Connection
PathInstalled equipment attachment path
Debug RequestEnabling this flag will log out the current request.false

List Invoices

Retrieves a list of invoices

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Job Cancel Reasons

Retrieve a list of job cancel reasons

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Jobs

Retrieve a list of jobs

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Locations

Retrieve a list of Locations

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Payments

Retrieve a list of payments

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Projects

Retrieve a list of Projects

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List Technicians

Retrieve a list of technicians

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

List User Roles

Gets a list of user roles

InputCommentsDefault
Connection
Fetch AllIf true, fetch all records, if false, will use the pageSize and page parametersfalse
PageThe page number to filter by
Page SizeHow many records to return (50 by default)
Include TotalInclude total count of records. If fetchAll is true, this will be ignored.false
SortApplies sorting by the specified field:'?sort=+FieldName' for ascending order,'?sort=-FieldName' for descending order.
Custom Query ParamsCustom fields filter
Debug RequestEnabling this flag will log out the current request.false

Raw Request

Send raw HTTP request to ServiceDesk Plus

InputCommentsDefault
Connection
URL TypeThe URL type to connect to. For example, jpm, crm, accounting, etc.
URLInput the path only (/jobs), The base URL is already included (https://api.servicetitan.io/jpm/v2/{YOUR-TENANT}/). For example, to connect to https://api.servicetitan.io/jpm/v2/{YOUR-TENANT}/jobs, only /jobs is entered in this field. e.g. /jobs
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Debug RequestEnable this to log the request and responsefalse
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false

Unassign Technician to Appointment

Un-assigns the list of technicians from the appointment

InputCommentsDefault
Connection
Job Appointment IDID of the job appointment
Technician IDsUnassign these technicians to the appointment.
Debug RequestEnabling this flag will log out the current request.false

Update Booking

Update a booking

InputCommentsDefault
Connection
Booking ProviderThe ID of the booking provider.
Booking IDThe ID of the booking.
SummarySummary of the booking
Is First Time ClientTrue if first time client
External IDExternal ID of booking
SourceThe source of the booking provider
NameName of the customer
AddressAddress of the booking
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Customer TypeType of the customer
StartStart date/time (in UTC)
Campaign IDID of the booking's campaign
Business Unit IDID of the booking's business unit
Job Type IDID of the booking's job type
PriorityBooking priority
Uploaded ImagesUploaded images
Debug RequestEnabling this flag will log out the current request.false

Update Customer

Update a customer

InputCommentsDefault
Connection
Customer IDThe customer ID.
NameName of the customer
Customer TypeType of the customer
AddressAddress of the booking
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Custom FieldsCustom fields for the request
[
{
"typeId": 0,
"value": "string"
}
]
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Do Not MailCustomer has been flagged as “do not mail”
Do Not ServiceCustomer has been flagged as “do not service”
ActiveWhether the customer is active
Tag Type IDsA list of tags ID's
Debug RequestEnabling this flag will log out the current request.false

Update Customer Contact

Updates a contact on the customers

InputCommentsDefault
Connection
Customer IDThe customer ID.
Customer Contact IDThe customer contact ID.
Customer Contact TypeType of the customer contact
Customer Contact Type ValueThe email, phone number, or fax number for the contact
MemoShort description about this contact, for example, “work #” or “Owner’s daughter - Kelly”
Debug RequestEnabling this flag will log out the current request.false

Update Installed Equipment

Update installed equipment by ID

InputCommentsDefault
Connection
Installed Equipment IDID of the installed equipment
NameThe name of the installed equipment
Installed OnThe date the equipment was installed
Serial NumberSerial number of the installed equipment
MemoThe memo of the installed equipment
ManufacturerManufacturer of the installed equipment
ModelModel of the installed equipment
CostCost of the installed equipment
Manufacturer Warranty StartManufacturer warranty start date
Manufacturer Warranty EndManufacturer warranty end date
Service Provider Warranty StartService Provider Warranty Start date
Service Provider Warranty EndService Provider Warranty End date
Custom FieldsThe custom fields of the installed equipment
[
{
"typeId": 0,
"value": "string"
}
]
AttachmentsList of attachments
[
{
"alias": "string",
"fileName": "string",
"type": {},
"url": "string"
}
]
Tag Type IDsA list of tags ID's
Debug RequestEnabling this flag will log out the current request.false

Update Invoice

Update Invoice

InputCommentsDefault
Connection
Invoice IDThe ID of the invoice.
NumberThe invoice number.
Type IDThe ID of the type of the payment.
Invoiced OnThe date the invoice was invoiced on.
SubtotalThe subtotal of the invoice.
TaxThe tax of the invoice.
SummaryThe summary of the invoice.
Royalty StatusThe royalty status of the invoice.
Royalty DateThe royalty date of the invoice.
Royalty Sent OnThe royalty sent date of the invoice.
Royalty MemoThe royalty sent date of the invoice.
Export IDGets or sets the identifier when exported.
Review StatusThe review status of the invoice.
Assigned To IDThe ID of the user the invoice is assigned to.
ItemsThe items of the invoice.
[
{
"skuId": 0,
"skuName": "string",
"technicianId": 0,
"description": "string",
"quantity": 0,
"unitPrice": 0,
"cost": 0,
"isAddOn": true,
"signature": "string",
"technicianAcknowledgementSignature": "string",
"installedOn": "string",
"inventoryWarehouseName": "string",
"skipUpdatingMembershipPrices": true,
"itemGroupName": "string",
"itemGroupRootId": 0,
"inventoryLocationId": 0,
"durationBillingId": 0,
"id": 0
}
]
PaymentsThe payments of the invoice.
[
{
"id": 0,
"settlementStatus": {},
"settlementDate": "string"
}
]
Debug RequestEnabling this flag will log out the current request.false

Update Invoice Custom Fields

Update custom fields for specified Invoices

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false
OperationsThe operations to perform on the invoice.
[
{
"objectId": 0,
"customFields": [
{
"name": "string",
"value": "string"
}
]
}
]

Update Invoice Items

Update invoice items

InputCommentsDefault
Connection
Invoice IDThe ID of the invoice.
DescriptionThe description of the SKU.
QuantityThe quantity of the SKU.
SKU IDThe ID of the SKU.
SKU NameThe name of the SKU.
Technician IDThe ID of the technician.
Unit PriceThe unit price of the SKU.
CostThe cost of the SKU.
Is Add OnIs the SKU an add on.
SignatureThe signature of the SKU.
Technician Acknowledgement SignatureThe technician acknowledgement signature of the SKU.
Installed OnThe date the SKU was installed on.
Inventory Warehouse NameThe inventory warehouse name of the SKU.
Skip Updating Membership PricesSkip updating membership prices.
Item Group NameThe item group name of the SKU.
Item Group Root IDThe item group root ID of the SKU.
Inventory Location IDThe inventory location ID of the SKU.
Duration Billing IDThe duration billing ID of the SKU.
IDThe ID.
Debug RequestEnabling this flag will log out the current request.false

Update Job

Update a job

InputCommentsDefault
Connection
Job IDThe job ID.
Customer IDThe customer ID.
Location IDThe ID of the location.
Business Unit IDID of the job's business unit
Job Generated Lead SourceObject that contains: JobId: ID of the job from which this job was generated EmployeeId: ID of the office user or technician
{
"jobId": 0,
"employeeId": 0
}
Job Type IDID of the job's type
PriorityPriority of the job
Campaign IDID of the job's campaign
SummaryJob summary
Should Update Invoice ItemsIf set to true, update the business unit of invoice items on job's invoice
Custom FieldsCustom fields for the job
[
{
"typeId": 0,
"value": "string"
}
]
Tag Type IDsTag type IDs for the job
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Customer POCustomer PO
Debug RequestEnabling this flag will log out the current request.false

Update Location

Update a location

InputCommentsDefault
Connection
Location IDThe ID of the location.
Customer IDThe customer ID associated with the location
NameThe name of the location
AddressThe address of the location
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
ActiveIf false, the location will be marked as inactive
Tax Zone IDID of the location tax zone
Custom FieldsCustom fields for the request
[
{
"typeId": 0,
"value": "string"
}
]
Tag Type IDsA list of tags ID's
External DataExternal data to attach to the request.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Debug RequestEnabling this flag will log out the current request.false

Update Payment

Update a specified payment

InputCommentsDefault
Connection
Payment IDThe ID of the payment.
Type IDThe ID of the type of the payment.
SplitsThe splits of the payment.
[
{
"invoiceId": 0,
"amount": 0
}
]
MemoThe memo of the payment.
Paid OnThe date the payment was paid on.
Auth CodeThe authorization code for the payment.
Check NumberThe check number for the payment.
Export IDGets or sets the identifier when exported.
StatusThe status of the payment.
Debug RequestEnabling this flag will log out the current request.false

Update Payment Custom Fields

Update custom fields for specified payments

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false
OperationsThe operations to perform on the payment.
[
{
"objectId": 0,
"customFields": [
{
"name": "string",
"value": "string"
}
]
}
]

Update Project

Update a project

InputCommentsDefault
Connection
Project IDID of the project to update
Project Manager IDsIDs of the project's managers
Jobs IDsIDs of the project's jobs
NameName of the project
SummarySummary of the project
Status IDProject status id
Sub Status IDProject sub status id
StartStart date of the project
Target Completion DateTarget completion date of the project
Actual Completion DateActual completion date of the project
Custom FieldsCustom fields for the project
[
{
"typeId": 0,
"value": "string"
}
]
External DataOptional model that contains a list of external data items that should be attached to this project.
{
"applicationGuid": "string",
"externalData": [
{
"key": "string",
"value": "string"
}
]
}
Debug RequestEnabling this flag will log out the current request.false

Update Technician

Update a technician

InputCommentsDefault
Connection
Technician IDThe ID of the technician to update
NameThe name of the technician
Phone NumberTechnician's phone number
EmailTechnician's email address
Login UsernameTechnician's username
Business Unit IDThe ID of the business unit to which the technician will be assigned
Role IDUser role Id
PositionsList of company positions
Azure Active Directory User IdAzure Active Directory User Id
License TypeLicense type
TeamTeam name
Daily GoalDaily revenue goal
Burden RateBurden rate (hourly)
BiographyBiography of the technician
MemoMemo for the technician
Job FilterUpcoming appointment visibility
Job History Date FilterAppointment history visibility
AddressThe home address of the technician
{
"street": "string",
"unit": "string",
"city": "string",
"state": "string",
"zip": "string",
"country": "string"
}
Custom FieldsCustom fields for the technician
[
{
"typeId": 0,
"value": "string"
}
]
Debug RequestEnabling this flag will log out the current request.false