Synchroteam API
Synchroteam is a cloud field service management platform used in 92 countries to schedule, dispatch, and track mobile workforces across HVAC, plumbing, electrical, maintenance, and utilities. An API lets you programmatically pull jobs, work orders, customers, sites, technicians, equipment, inventory, and invoices—and push updates like new jobs, schedule changes, time entries, and invoices back into Synchroteam.
What is Synchroteam?
Synchroteam is a cloud-based field service management platform that helps organizations schedule, dispatch, and manage mobile workforces across 92 countries. Field service teams use Synchroteam to optimize routes, assign and track jobs, capture data with custom forms in the field, manage contracts and inventory, and quote, invoice, and collect payment at the worksite—through web dashboards and iOS/Android mobile apps.
Core product areas include:
- Scheduling & Dispatch (drag-and-drop assignment, route optimization, map and GPS tracking)
- Job Management (advanced search, custom forms, online booking portal)
- Field Service CRM (customer database, sites, contract management with SLA tracking)
- Time Tracking (regular and overtime, clock in/out, travel and activity logging)
- Inventory Management (stock across depots and vehicles, parts and equipment)
- Quotation, Invoicing & Payments (job quotes, invoices, on-site payment capture)
- Customer Portal (job visibility and self-service booking)
Common data entities:
- Jobs, Work Orders, Schedules, Dispatch Assignments
- Customers, Sites, Contracts (SLAs)
- Users/Technicians, Teams
- Equipment, Parts, Inventory Movements
- Activities (clock in/out, travel, work, unavailability)
- Quotations, Invoices, Payments, Attachments, Custom Fields
The Synchroteam Integration Challenge
Field service teams run dispatch and job workflows on Synchroteam every day, but turning that activity into reliable API-driven automation across web and mobile surfaces is non-trivial:
- Per-tenant domain and API key: Basic-auth credentials are scoped to each company's personalized domain identifier, so generic integrations must be provisioned and rotated per account
- Mobile-first field data: Time entries, custom-form captures, photos, and signatures originate in the iOS/Android apps and surface asynchronously, complicating real-time pulls
- Rate and quota ceilings: The API enforces both a per-minute request rate and a daily request quota, so high-volume syncs need careful throttling and backoff
- Custom fields per object: Jobs, customers, sites, equipment, and users each carry account-specific custom fields that generic schemas drop or mishandle
- Pagination and totals: List endpoints page in small batches with maximum page sizes, so full extracts require disciplined cursoring across recordsTotal
- Versioned API surface: Coverage and object shapes differ between the v2 and v3 web services, so integrations must target the right version per endpoint
How Supergood Creates Synchroteam APIs
Supergood combines Synchroteam's documented v3 web services with authenticated browser flows to deliver a resilient, normalized API layer for your Synchroteam account—across jobs, scheduling, CRM, inventory, and invoicing.
- Manages your per-domain identifier and API key in an encrypted vault, with secure Basic-auth handling and credential rotation
- Respects per-minute rate limits and daily quotas with adaptive throttling, backoff, and pagination across recordsTotal
- Normalizes responses across Jobs, Customers, Sites, Users, Equipment, Parts, and Invoices so you integrate once and rely on consistent objects
- Preserves account-specific custom fields on jobs, customers, sites, equipment, and users rather than forcing a generic schema
Use Synchroteam with AI agents: Synchroteam MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, mobile workflows, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Synchroteam adapter tailored to your account configuration and custom fields.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Synchroteam evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Synchroteam account using your domain identifier and API key (HTTP Basic) and establish a managed session for downstream calls.
Jobs
/jobsList jobs and work orders with filters for status, technician, customer, site, and scheduled date range.
Jobs
/create_jobCreate and schedule a new job against a customer and site, assigning a technician and job type.
Customers
/customersRetrieve customers and their service sites, including contracts, SLAs, and custom fields.
Workforce
/usersList technicians, teams, and their activities including clock in/out, travel, and unavailability.
Billing
/invoicesPull invoices and quotations with status, amount, and customer filters across job-level financials.
Use Cases
Sync jobs and dispatch data into your systems
- Pull scheduled, in-progress, and completed jobs with technician and site assignments into a warehouse - Stream job status and completion events to downstream BI and customer-notification tools - Reconcile work orders against customer and contract records for unified reporting
Automate work order and scheduling workflows
- Create and schedule jobs from your CRM or ticketing system without manual dispatch entry - Push schedule changes and technician reassignments back into Synchroteam - Trigger route-optimization and online-booking flows from upstream demand signals
Reconcile invoicing and time tracking
- Sync quotations, invoices, and on-site payments into accounting and AR systems - Match technician time entries and overtime against jobs for payroll and labor costing - Surface unbilled completed jobs to revenue and billing workflows
Keep inventory and equipment data in sync
- Pull parts, stock levels, and inventory movements across depots and vehicles - Update equipment records and service history from field captures - Trigger replenishment and procurement workflows when stock thresholds are crossed
Technical Specifications
Authentication
HTTP Basic auth using your domain identifier and API key, handled in a managed, encrypted session
Connectivity
Synchroteam v3 web services (ws.synchroteam.com/Api/v3) plus authenticated browser flows where endpoints are not exposed
Response format
Normalized JSON across Jobs, Customers, Sites, Users, Equipment, Parts, and Invoices
Rate limits
Adaptive throttling under Synchroteam's per-token limits (~1000 requests/minute) to avoid platform-side rejection
Session management
Automatic credential handling, key rotation, and re-authentication on expiry
Data freshness
Near real-time pulls for jobs, schedules, and invoices with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access, TLS 1.2+, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for job creation, status change, completion, and invoice updates
Latency
Sub-second reads on cached entities; multi-second writes when creating jobs and posting invoices
Throughput
Horizontally scaled workers sized to your job and field-activity volume within the daily quota (~15,000 requests/day)
Reliability
Retry, backoff, idempotency keys, and disciplined pagination across recordsTotal
Adaptation
Continuous monitoring of Synchroteam v2/v3 API changes and account-specific custom-field drift
Frequently asked questions
Yes. Supergood builds on Synchroteam's documented v3 web services using your domain identifier and API key, and supplements with authenticated flows where an endpoint isn't exposed—so you get a single normalized surface across jobs, CRM, inventory, and invoicing.
Synchroteam enforces both a per-minute request rate and a daily quota per token. Supergood applies adaptive throttling, backoff, and pagination across recordsTotal so high-volume syncs stay within limits without dropping records.
Yes. Custom fields on jobs, customers, sites, equipment, and users are preserved through the normalized API rather than being dropped or flattened into a generic schema.
Yes. Time entries, custom-form captures, attachments, and activity logs that originate in the iOS and Android apps surface through the same normalized endpoints once they sync to your account.
Supergood targets the v3 web services by default and falls back to v2 endpoints where object coverage requires it, abstracting the version differences behind one consistent interface.