Using the Nestr API

Generate a Nestr API key

The Nestr api allows manipulation of items from outside the Nestr application. The api can be used to create an integration with other applications, or to easily add items from anywhere.

To get started, go to your workspace settings where you will find a tab called Integrations

There you will find the Workspace API access integration. Click configure and create a new API key.

You can optionally name the API key and give a description. If you have multiple integrations, it pays to setup a key for each one and name them accordingly. Once you have named your API key, click Create API key. This will generate and store the key for you. We will only show you the key once, so make sure you copy it and store it securely in a password manager.

Personal API keys

The key above is a workspace API key. It belongs to the workspace and acts for the workspace as a whole, not for a person. You can also create a personal API key. A personal API key acts as you.

• Workspace API key: created by a workspace admin in the workspace settings. It is limited to that one workspace and has no user identity, so personal features such as your inbox and daily plan are not available through it. You can attach a rights profile to limit what it may do.
• Personal API key: created by you on your own settings page. Every call is made as you, with exactly the rights you have. It reaches every workspace you are a member of and your personal data, such as your inbox, daily plan, profile and personal labels. It can never do more than you can do yourself in the app.
• OAuth: used by apps and integrations such as Zapier or an AI assistant connected through MCP. You do not copy a key. The app sends you to Nestr, you click Authorize, and the app receives its own access. When you authorize, you choose between your full account or a single workspace.

Personal API keys do not expire. A key works until you revoke it. When you create one you can tick Read-only, so the key can read data but cannot create, change or delete anything.

Create a personal API key

1. Go to https://app.nestr.io/profile#integrations. You can also open your settings page and select the Integrations & API tab.
2. In the API Keys card, click New API key.
3. Give the key a name and, optionally, a description. Tick Read-only if the integration only needs to read data.
4. Click Create API key. Copy the key and store it in a password manager. We only show it once.

Review and revoke keys and connected apps

The API Keys card on https://app.nestr.io/profile#integrations lists more than the keys you created yourself. It also lists every app and integration you have authorized through OAuth to access your account, for example Zapier or an AI assistant such as Claude or ChatGPT connected through MCP. Each entry shows:

• The app name and logo. Your own personal keys show as Nestr with the name you gave the key underneath. An AI assistant connected through MCP shows as Nestr followed by the assistant, for example Nestr / Claude, often with its version. Other apps show their own name, for example Zapier.
• What the entry can reach: User account for your full account, or User account plus a workspace name when it was limited to one workspace.
• A Read-only tag when the key cannot make changes.
• When it was last used and how many calls it has made, or Never used.

Click Revoke next to an entry to remove its access straight away. For a personal key, the key stops working. For an app you authorized through OAuth, revoking removes that grant, so the app loses access and has to ask you to authorize it again before it can reconnect. Any integration still using a revoked key or grant will start failing.

Workspace API keys are not in this list. You manage those in the workspace settings, as described above.

Use your Nestr API key

The Nestr API key is a Bearer token. You can find the full API documentation and examples on our API documentation page.

Send the key in the Authorization header of every request, for example Authorization: Bearer YOUR_API_KEY. This works the same for workspace keys and personal keys.