Skip to main content
You create and revoke Tella API keys in Settings → API Keys, under Other: click your workspace name in the top-left corner, then Settings. Each key is shown only once, and you can have up to 10 at a time. An API key authenticates requests to Tella on your workspace’s behalf. You need one for the public API and webhooks and for scripts that call Tella. The Tella MCP server usually signs in with OAuth instead, but also accepts an API key.
Members with the Viewer role cannot open this page. Ask a workspace owner or member to create a key for you.

Create a key

  1. Go to Settings → API Keys.
  2. Click Create key.
  3. In Create API key, name the key after where it will be used, such as Production API key. The name is only a label; it doesn’t affect what the key can do.
  4. Click Create.
  5. Copy the key straight away and store it somewhere safe.
The full key is shown only once, when you create it. If you lose it, revoke the key and create a new one.

What does the key list show?

Each key in the table shows:
  • Name: the label you gave it.
  • Key: the first few characters of the key. This prefix is enough to tell keys apart, but it is not the key itself.
  • Created: when the key was made.
  • Last used: when a request last used it, or Never if nothing has used it yet.
Keys showing Never, or unused for months, are good candidates to revoke.

Revoke a key

  1. Find the key in the table.
  2. Click Revoke.
  3. Confirm.
Revoking takes effect immediately, and any application still using that key stops working. If an integration breaks after you revoke, update it with a new key.

What happens to my keys if I leave the workspace?

They stop working. A key only works while its creator is a member of the workspace it was created in; once you’re removed, requests with your keys are rejected as invalid within about a minute. For integrations that should outlive one person’s membership, use a key created by someone who stays in the workspace.

How do I keep API keys safe?

  • Treat a key like a password: anyone holding it can act on your workspace through the API.
  • Do not commit keys to a repository, paste them into a prompt, or share them in chat.
  • Use a separate key per integration, so you can revoke one without breaking the others.

Is there a limit on API keys?

Yes. You can have up to 10 API keys at a time. If creating a key fails with “Maximum of 10 API keys allowed per user”, revoke one you no longer use and try again.

Use your key

For how to send the key with a request, see the authentication guide in the developer documentation.
Last modified on November 19, 2026