API and agents

The interactive reference for the documented operations, the index of every operation a key can call, and the OpenAPI document to download.

Set explicit start and finish choices, private bases and daily overrides without changing appointments.

Every error a Nova integration or AI agent can get, the exact response it arrives in, and what to do next.

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.

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.

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.

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.

The conventions every Nova operation follows for lists, record identity, updates, the error envelope, idempotency and rate limits.

Analyze a bounded text sample, check for existing customer records and explicitly confirm an atomic account capture.

Interpret road times, missing calculations and spending limits without treating unknown driving as zero.

Get a token as a connected app (OAuth 2.1 with PKCE), as an AI teammate (client credentials) or as an integration (API key), and send it on every call.

Three ways into one API: an API key for your own software, an OAuth connected app for a product other people use, and an AI teammate for AI that works on its own. Which to pick and why.

The per-minute limits, the optional daily cap on changes, working hours, address allowlists, expiry and branch limits that can apply to an API key, connected app or AI teammate.

Every scope a key, connected app or agent can hold, what each one allows, and the rules that keep a scope from ever granting more than the person or role behind it.

Connect Claude, ChatGPT or any MCP-capable assistant to Nova, as a person or as an AI teammate, and what it can reach once connected.

When an action needs a person's approval, the call answers approval_required. Why it happens, what the response holds, how long it lasts, and how to finish the action once approved.

Sign in as an organization's AI teammate with client credentials, and what working as one means for your calls — its roles, grant, working hours, daily cap, customer disclosure and activity.

The tools, resources and prompts Nova's MCP server offers, including find_operations and call_nova_operation, which reach everything a connection's grant covers.

Subscribe an endpoint to Nova events, verify the signature on every delivery, and replay what you missed.