Skip to content
  • There are no suggestions because the search field is empty.

ServiceTitan Setup

Setup should only take 5-10 minutes

⚠️ NOTE

There may be fees associated with setting up a new data connection. Contact your account team to confirm pricing.

Pre-Implementation

You must have administrator permissions in ServiceTitan to set up the connection in BUCS. 

Configuration Steps in ServiceTitan

This section covers the following steps that must be taken from ServiceTitan before moving forward with connection in the BUCS platform:

  1. Create a BUCS Analytics user
  2. Create a BUCS App
  3. Connect the BUCS App to ServiceTitan account

Create a BUCS Analytics User in ServiceTitan

Create a new BUCS Analytics user and give the user permission to Manage API Access and Generate API Application Key.

1. Login to your ServiceTitan account and go to Settings > People > Employees > Add.      

bucs-servicetitan-data-connection-setup-02-create-a-bucs-analytics-user-in

2. Provide the user profile details:

  • Employee Name: BUCS Analytics
  • Role: Select the appropriate role based on your organizational structure
  • Company Position: Select the appropriate position based on your organizational structure
  • Email: Use the email address of the person managing the BUCS Analytics data connection
  
 bucs-servicetitan-data-connection-setup-03-create-a-bucs-analytics-user-in

3. Click on the Permissions tab and make sure there is a checkmark in front of Generate API Application Key and Manage API Application Access.    
                bucs-servicetitan-data-connection-setup-04-create-a-bucs-analytics-user-in
4. Click Save.


Create a BUCS App in ServiceTitan 

1. Login to Login to My Apps - ServiceTitan API - developer portal

2. Click on Login as Production Environment User.

bucs-servicetitan-data-connection-setup-05-create-a-bucs-app-in-servicetitan

3. Log in with the BUCS Analytics user you created in the section above.

4. Click +New App

bucs-servicetitan-data-connection-setup-06-create-a-bucs-app-in-servicetitan

5. Enter the following information in the App details page and then click :   

  • Application Name: BUCS
  • Organization: BUCS
  • Homepage: https://bucsanalytics.com/
  • Tenant: Input your Tenant ID(s) here (see note below)
  • Customer Global Network(s): Ignore
  • External Data Application GUID: Ignore
  • API Scopes: Check Read for every box

bucs-servicetitan-data-connection-setup-08-create-a-bucs-app-in-servicetitan

🗒️ NOTE

If your ServiceTitan account only has one tenant, it should appear in this field by default. If you manage more than one ServiceTitan tenant, you can add all the tenants here. You can also rename or assign nicknames to the tenants from here.

You find your Tenant ID by logging into ServiceTitan and going to Integrations > API Application Access and locating your Tenant ID in the top-right corner.

bucs-servicetitan-data-connection-setup-10-create-a-bucs-app-in-servicetitan

Saving the app will redirect you to the ServiceTitan My Apps page. 

Connect the BUCS App in ServiceTitan

Connect the BUCS App you just created to your ServiceTitan account so BUCS can access your ServiceTitan data.     

🗒️ NOTE

If setting up connections for multiple tenants, you will need to complete the steps below for each individual tenant.                                                                

1. Log into your ServiceTitan account and go to Settings > Integrations > Application Access.

bucs-servicetitan-data-connection-setup-12-connect-bucs-app-to-your-servicetitan

2. Click Connect New App.

bucs-servicetitan-data-connection-setup-13-connect-bucs-app-to-your-servicetitan

3. Select the BUCS app you just created per the instructions above and click Connect.

4. On the next screen, select No restriction for the Booking Restrictions field, select NexTraq (or retain the default selection) for the GPS Pings field, and select No restriction for the Reports Category field.

5. Click Allow Access. A green banner indicating the app was connected will appear. 

bucs-servicetitan-data-connection-setup-15-connect-bucs-app-to-your-servicetitan


bucs-servicetitan-data-connection-setup-16-connect-bucs-app-to-your-servicetitan
8. Click Generate next to the Client Secret field to generate, view, and copy the Client Secret.

❗IMPORTANT

Under the Application Details section, copy and retain the values for Tenant ID, Client ID, and Client Secret. This information is required to complete your data connection from the BUCS Connection wizard in the next section.


Implementation Steps in BUCS                                               

🗒️ NOTE

If setting up connections for multiple tenants, you will need to complete the steps below for each individual tenant.                     

1. Go to Customer Portal > Connection Management > Connection Hub. 

2. Locate or search for the ServiceTitan connector and click Connect.

bucs-sage-intacct-data-connection-setup-15-create-a-sage-intacct-connection-in-bucs

3. Enter a name for your connection and click Next. The connection name should be descriptive and specific to the connection. bucs-servicetitan-data-connection-setup-21-create-a-servicetitan-connection-in-bucs4. Enter your ServiceTitan Tenant ID, Client ID and Client Secret you had copied and retained in the steps above and then click Save. bucs-servicetitan-data-connection-setup-22-create-a-servicetitan-connection-in-bucs

A Connection Established message will appear if the connection was successful and data from Acumatica will continuously sync to BUCS. If the connection was not successful, you will be prompted to try again.

🗒️ NOTE

It may take up to 24 hours for ServiceTitan data to appear in the BUCS platform.