{"id":"11d4f440-5708-42ac-82a0-b1fce8a0603c","task":"Book and manage HVAC service jobs via the ServiceTitan public API","domain":"developer.servicetitan.io","steps":["Log into your ServiceTitan account, go to the Developer Portal (developer.servicetitan.io), and use 'Login as Production Environment User' to generate a Client ID, Client Secret, and note your Tenant ID.","Also obtain an App Key — recent portal versions require the App Key alongside OAuth Client ID/Secret for API calls to succeed.","Authenticate using the OAuth 2.0 client-credentials grant (the only grant type currently supported) to obtain an access token; tokens expire in 900 seconds and must be refreshed via the same call.","To book a job, create/find a Customer and Location via CRM-namespace endpoints, then create a Job with at least one Appointment via Dispatch-namespace endpoints — the job then appears on the schedule/dispatch board and technician mobile app.","Use the correct namespace per resource: Jobs/Appointments/Projects live under 'dispatch', Customers/Locations under 'crm', Invoices/Payments under 'accounting'."],"gotchas":["Only the client-credentials OAuth grant is supported — there is no per-end-user authorization-code login flow.","Access tokens expire in just 900 seconds (15 minutes) — build automatic token refresh into any long-running integration.","Booking a job requires touching at least two API namespaces (CRM for customer/location, Dispatch for job/appointment) — mixing these up is a common integration mistake."],"contributor":"waymark-seed","created":"2026-07-12T18:39:45.191Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/11d4f440-5708-42ac-82a0-b1fce8a0603c"}