ServiceTitan API - HVAC, Plumbing & Electrical Contractor Data

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

Access ServiceTitan data for home services businesses. Get jobs, customers, invoices, technicians, estimates, dispatch, inventory, memberships, and marketing data. Perfect for HVAC, plumbing, electrical, and other trade contractors.

Features

• Jobs & Dispatch: Job details, scheduling, dispatch board, technician assignments
• CRM: Customers, locations, leads, bookings, contacts
• Financials: Invoices, payments, estimates, pricebook
• Workforce: Technicians, performance metrics, payroll
• Operations: Inventory, equipment, service agreements
• Marketing: Campaigns, calls, lead tracking
• Memberships: Membership programs and service agreements
• Demo Mode: Test with realistic sample data (no credentials required)

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Task Selection

• task: Operation to perform
  • get_jobs - Get jobs list
  • get_job_details - Get specific job details
  • get_customers - Get customers
  • get_customer_details - Get customer details
  • get_locations - Get service locations
  • get_leads - Get sales leads
  • get_bookings - Get bookings
  • get_estimates - Get estimates
  • get_invoices - Get invoices
  • get_payments - Get payments
  • get_technicians - Get technicians
  • get_technician_performance - Get tech performance
  • get_dispatch_board - Get dispatch board
  • get_inventory - Get inventory items
  • get_equipment - Get equipment records
  • get_memberships - Get memberships
  • get_service_agreements - Get service agreements
  • get_marketing_campaigns - Get campaigns
  • get_calls - Get call records
  • get_payroll - Get payroll data

Authentication

• clientId: OAuth Client ID
• clientSecret: OAuth Client Secret
• appKey: Application Key
• tenantId: Tenant ID
• demoMode: Run with sample data

Filters

• jobId: Specific job lookup
• customerId: Filter by customer
• technicianId: Filter by technician
• startDate / endDate: Date range
• jobStatus: Filter by status
• businessUnitId: Filter by business unit
• campaignId: Filter by campaign

Pagination

• limit: Max records (up to 500)
• offset: Page offset

Output Format

{
  "data": [...]
}

Pricing

This actor uses pay-per-event billing: Pay only for what you use:

• Jobs Query: $0.01 per query
• Customer Lookup: $0.01 per lookup
• Invoice Query: $0.01 per query
• Technician Performance: $0.02 per query
• Dispatch Board: $0.02 per query
• Marketing Data: $0.01 per query

Use Cases

HVAC Contractors

• Track job completion rates and revenue
• Monitor technician performance and efficiency
• Analyze seasonal demand patterns
• Export customer data for marketing

Plumbing Companies

• Manage service calls and dispatch
• Track inventory and parts usage
• Monitor invoice collection rates
• Analyze customer lifetime value

Electrical Contractors

• Schedule and dispatch technicians
• Track estimates vs. completed jobs
• Monitor marketing campaign ROI
• Manage membership programs

Multi-Trade Operations

• Unified reporting across business units
• Cross-sell analysis between services
• Capacity planning and forecasting
• Franchise performance comparison

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal