API
Build integrations and automate workflows with the Ergova API.
The Ergova API lets you read and write jobs, customers, schedules, and more. Use it to connect your own tools, build custom workflows, or sync data with other systems. API access is included on Grow plans and above.
What you can do
- •Jobs. Create, update, and list jobs. Set status, assign technicians, and manage custom fields.
- •Customers. Manage customer records, addresses, and contact info. Link jobs to customers.
- •Schedule. Read and update schedule slots. Integrate with external calendars or dispatch logic.
- •Invoices & payments. Create invoices, send payment links, and query payment status.
Authentication
API requests use API keys (or OAuth for third-party apps). Keys are scoped to your account and can be created in your account settings under Developers. Use separate keys for development and production, and never expose keys in client-side code.
Webhooks
Subscribe to events such as job created, job status changed, payment received, and invoice sent. We send POST requests to your endpoint with a signed payload so you can verify authenticity. Retries use exponential backoff. Configure webhook endpoints and event types in your developer settings.
Rate limits & availability
Rate limits depend on your plan. Responses include headers with current usage and reset time. We document limits and best practices in the full API reference. API status and incident updates are communicated via status page and email when relevant.
Getting access
API access is included on Grow and higher plans. If you’re on a lower plan and need API access for an integration, contact us to discuss. We’ll send you base URLs, authentication details, and a link to the full API reference after your account is enabled.
