Troubleshooting

What to do if the connection test fails, a refresh gets stuck, an answer times out, or a number looks wrong.

Connection test fails

1. Open the ServiceTitan developer portal, edit your application, and confirm the read scope is selected for each failed area.
2. In ServiceTitan go to Settings, then Integrations, then API Application Access, and click Update to New Version for this app.
3. Test again.

Confirm the four credentials were copied correctly, and that you connected the app in ServiceTitan before copying them. If credentials will not save and the app says secure storage is not ready, wait a minute and try again. See Set up Titan Connect.

Refresh stuck or failed

A pull can take a few minutes. If it makes no progress for 30 minutes, it is marked failed. Use Pull now. If an area is missing, read the pull summary; the app names any area that did not respond and why.

Slow answers or timeout

Starters and short questions like sales yesterday should be fast when data is current. Broader questions can take longer because the AI may look at the data more than once. After 60 seconds you will see "This is taking too long. Try again, or ask a narrower question." and a Try again button.

• Try a starter question.
• Narrow the date range in the question.
• Pick a faster model such as Gemini Flash. See Models and Lovable AI credits.

Wrong-looking numbers or dates

• Check the time zone and the "data as of" line on the answer.
• Calendar days use your saved refresh time zone, or Eastern Time if that zone was never set or was UTC.
• A day can be partial if the last pull finished before midnight in that zone.
• The copy only covers the date range you chose, and reference records (customers and locations) are only those tied to pulled rows.
• Official metric caveats still apply. See ServiceTitan metric definitions.
• Refresh the data if the copy has expired or is stale.

"Your data has expired"

The copy was deleted after 24 hours. Pull the data again, then ask the question once more.

Lovable credits

Models run on your Lovable AI credits. If answers stop completing, check your Lovable account credits.

Still stuck

Contact ST Hacks.

Need more help? Contact us. New to Titan Connect? Start with the DIY ServiceTitan Chatbot course.