> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invoca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceTitan Integration for Invoca AI Agents

> Connect ServiceTitan to Invoca AI agents to find customers and service locations, check the schedule, and submit booking requests for your dispatchers.

The ServiceTitan integration lets your Invoca AI agents look up customers and service locations in ServiceTitan, check the schedule, and submit booking requests during a conversation. Your dispatchers then turn each booking request into a job, just as they do with other booking sources.

It works with both voice and SMS agents.

| Capability | What the agent can do | Changes ServiceTitan data? |
| - | - | - |
| Customers and locations | Find the caller's customer record and service locations; create or update a customer | Yes, after the caller confirms |
| Leads | Find, create, or update a lead | Yes, after the caller confirms |
| Schedule check | See existing appointments in a time window to spot conflicts | No |
| Booking requests | Submit a booking request for the time the caller wants | Yes, after the caller confirms |
| Appointments and jobs | Look up and reschedule an existing appointment; look up and update a job | Yes, after the caller confirms |

Setup takes three steps: create API credentials in ServiceTitan, connect them in Invoca, and attach the skill to your agent's Schedule Appointment action. Invoca recommends setting it up with your Invoca team.

## Before you begin

* **ServiceTitan is enabled on your Invoca account.** If you don't see it in Manage Integrations, contact Invoca.
* **A ServiceTitan admin is available** to approve Invoca's access and create API credentials (a client ID and client secret).
* **You know your ServiceTitan tenant ID.** Every request the agent makes is tied to this ID. If your company has more than one tenant, decide which one the agent uses.
* **You have a booking provider for Invoca.** Booking requests are filed under a booking provider in ServiceTitan, so your dispatchers can see where they came from.
* **Optional:** the campaign, business unit, and job type IDs you want booking requests to carry.

## Connect ServiceTitan

You connect by approving Invoca in ServiceTitan and entering the API credentials it gives you.

**In ServiceTitan (admin):**

1. Approve Invoca's access to your tenant. Your Invoca team will guide you through this step.
2. Copy the **client ID** and **client secret** for the connection, and note your **tenant ID**.

**In Invoca:**

1. Open **Manage Integrations** and select **ServiceTitan**.
2. Add a new credential and enter the client ID and client secret. Invoca checks them when you save.
3. Confirm the connection shows as connected.
4. Give your Invoca team your tenant ID and booking provider, so the agent sends requests to the right place.

## Configure booking details

Your Invoca team sets up these details with you so booking requests land in the right place in ServiceTitan.

| Detail | What it's for | Required? |
| - | - | - |
| Tenant ID | Which ServiceTitan tenant the agent reads and writes | Yes |
| Booking provider | Where booking requests appear in ServiceTitan | Yes, to submit booking requests |
| Campaign | Attributes booking requests to a marketing campaign | Optional |
| Business unit | Routes booking requests to the right team | Optional |
| Job type | Used when the agent updates a job | Optional |

Also agree on your booking rules, such as which services the agent may book and how far out, so they can go into your agent's instructions.

## Add the skill to your AI agent

1. Open your agent in **Agent Builder**.
2. Open the **Schedule Appointment** action.
3. In the skill field, choose the ServiceTitan skill, then choose your ServiceTitan connection.
4. Test the agent against a test customer, then publish it.

## How the agent works with ServiceTitan

Before any change, the agent summarizes the customer, location, date, time, and change, and waits for the caller to confirm. It searches for an existing customer before creating one, and gives times in the caller's timezone.

| Caller asks to | What the agent does in ServiceTitan |
| - | - |
| Book service | Finds the customer and service location, checks existing appointments in the window, confirms, then submits a booking request. |
| New customer | Searches by name, phone, email, or address first, then creates the customer once the caller confirms the details. |
| Reschedule | Finds the appointment, checks the new window, confirms, then moves it. |
| Update details | Updates the customer, service location, lead, or job details the caller gives. |

A booking request isn't a dispatched job. It appears in ServiceTitan for your dispatchers to review and schedule, and the agent tells the caller your team will confirm. The schedule check shows existing appointments that could conflict, not open technician capacity.

## Data and privacy

* **No reading back stored data.** The agent only confirms details the caller gave, and never shares other customers' information.
* **No made-up results.** The agent only reports what ServiceTitan returns. If a save fails, it tells the caller nothing was scheduled.
* **No internal details.** The agent doesn't say IDs, error messages, or system terms to the caller.
* **You stay in control.** To stop access, remove the connection in Manage Integrations, or revoke Invoca's access in ServiceTitan.

## Limitations

* **Booking requests, not jobs.** The agent can't create jobs or appointments directly. Your dispatchers schedule each booking request.
* **No capacity check.** The agent sees existing appointments, not technician availability.
* **No cancellations.** The agent can't cancel appointments, jobs, or bookings. Route cancellation requests to your team.
* **No new service locations.** The agent can update a location but can't create one.
* **One tenant per agent.** The agent works in the one tenant you set up.

## Troubleshooting

| What you see | Likely cause | What to do |
| - | - | - |
| ServiceTitan isn't listed in Manage Integrations | It isn't turned on for your Invoca account | Contact Invoca to turn it on |
| Credentials fail when you save | The client ID or secret is wrong, or Invoca's access wasn't approved | Check the values and the approval in ServiceTitan |
| The agent can't find customers | The agent is set up for a different tenant | Confirm your tenant ID with your Invoca team |
| Booking requests don't appear | The booking provider is missing or wrong | Confirm the booking provider with your Invoca team |
| Callers think their job is confirmed | Booking requests still need a dispatcher | Review booking requests promptly, and adjust the agent's wording if needed |
| A caller wants to cancel | The agent can't cancel | Route cancellations to your team |

Still stuck? Contact Invoca with the agent name and the time of the conversation.


## Related topics

- [Zoom Integration for Invoca AI Agents](https://docs.invoca.com/s/article/zoom-agent-integration.md)
- [Salesforce Integration for Invoca AI Agents](https://docs.invoca.com/s/article/salesforce-agent-integration.md)
- [Calendly Integration for Invoca AI Agents](https://docs.invoca.com/s/article/calendly-agent-integration.md)
- [Microsoft Outlook Integration for Invoca AI Agents](https://docs.invoca.com/s/article/microsoft-outlook-agent-integration.md)
- [Dentrix Ascend Integration for Invoca AI Agents](https://docs.invoca.com/s/article/dentrix-ascend-agent-integration.md)
