Nova Getting started
What the API covers, your first request, conventions and the reference.
- API reference
The interactive reference for the documented operations, the index of every operation a key can call, and the OpenAPI document to download.
- Configure daily route arrangements through the API
Set explicit start and finish choices, private bases and daily overrides without changing appointments.
- Errors and how to recover
Every error a Nova integration or AI agent can get, the exact response it arrives in, and what to do next.
- Find the operation to call
Use the operation index to find any of Nova's roughly 3,200 callable operations and the exact permission each one needs, not just the documented starter set.
- How records are identified
Every Nova record has an opaque uid for software and a record number for people. Which to send, which to show, and the few identifiers that are not records.
- Make your first API request
Create an API key in Nova, call the API from the command line, read the response, and know what to try next. Ten minutes, no OAuth.
- Nova API overview
What the Nova API covers, the three ways software connects, how records are addressed, and where to start as an integration or an AI agent.
- Paging, filtering, errors and rate limits
The conventions every Nova operation follows for lists, record identity, updates, the error envelope, idempotency and rate limits.
- Review account details from a conversation through the API
Analyze a bounded text sample, check for existing customer records and explicitly confirm an atomic account capture.
- Understand route road calculations
Interpret road times, missing calculations and spending limits without treating unknown driving as zero.