Create API keys and use the NestWatch API

The NestWatch API lets your own tools and scripts read and create your workspace's data: properties, homeowners, visits, issues, and invoices, plus read-only access to reports. It is available on the Business plan, and every request is scoped to your workspace only.

Create a key

1. Go to Settings and open API keys. You need the owner or admin role.
2. Click Create key and give it a name that says what it is for, like "Reporting script".
3. Copy the key right away. It starts with "nw_" and is shown only once; after that, the list shows just the prefix and last four characters.
4. Store it somewhere secret, like a password manager. You can keep up to 10 active keys.

Make requests

Send the key as a bearer token in the Authorization header of every request. Endpoint reference, request and response examples, error codes, and pagination details live in the developer documentation.

• Each key is limited to 120 requests per minute. Going over returns HTTP 429 with a Retry-After header telling you when to try again.
• Requests with a missing, invalid, or revoked key return HTTP 401.
• If your workspace is not on Business, requests return HTTP 402 with an upgrade message.

Revoke a key

Revoke any key from the same Settings page. Revocation takes effect immediately: the next request with that key is rejected. Revoke and replace a key any time you suspect it leaked, when a teammate with access leaves, or when a tool no longer needs it.