Docs / Account & billing

API & extension keys

Overview

Your account has one secret key. It does two jobs: it tells the Setell Chrome extension which account to push email into, and — if you're on Pro — it's the key that connects Setell to an agent like Claude or ChatGPT through the API. You create it, copy it once, and can rotate or revoke it any time.

The key itself is free to make on any plan. Using it to drive Setell from an agent (the API / MCP surface) is a Pro feature. The Chrome extension works on any plan.

Before you start

  • You're signed in to Setell.
  • For agent/API use: a Pro plan.

Create your key

  1. Open Settings and find the Chrome Extension API Key card.
  2. Click Create Extension Key.
  3. Setell shows the full key once. Click Copy and paste it somewhere safe right away.
You only see the full key once. After you dismiss it, Setell shows just the first few characters (setell_ext_…). If you lose it, rotate to get a new one.

Use your key

  • Chrome extension: paste the key into the Setell extension popup. It now pushes email into your account. See docs/integrations/chrome-extension.
  • Agent / API (Pro): set the key as your SETELL_EXTENSION_KEY in your agent's config (Claude, ChatGPT, Claude Code). Setell uses it to confirm who's calling. See docs/mcp/connect.

Rotate or revoke

  • Rotate makes a fresh key and retires the old one — do this if you think the key leaked, or on a regular schedule.

- After rotating, paste the new key into your extension and any agent config — the old one stops working.

  • Revoke turns the key off entirely. The extension and any agent stop working until you create a new one.

What happens next

  • A new or rotated key is active immediately; the previous one is dead the moment you rotate or revoke.
  • Only one key is active per account at a time. Creating again replaces what was there.

Troubleshooting

  • My extension stopped working after I rotated. That's expected — rotating retires the old key. Paste the new key into the extension popup.
  • I lost my key. There's no way to re-show it. Click Rotate to get a fresh one, then update wherever you'd pasted it.
  • My agent gets "unauthorized" (401). The key is missing or wrong in your agent config. Re-copy a fresh key (rotate) and paste it as SETELL_EXTENSION_KEY.
  • My agent gets "payment required" (402). API / agent access needs Pro. Upgrade in Settings → Billing.
  • Still stuck → docs/reference/troubleshooting.

FAQ

  • Is the extension key the same as the embed key? No. The embed key powers the quote-request form you put on your website — that's a separate key on the same Settings page. See docs/integrations/website-embed.
  • Can I have more than one key? No — one active key per account. Rotating replaces it.
  • Do I need Pro just to use the Chrome extension? No. The extension works on any plan. Pro is only for the agent / API surface.
  • Where do I keep the key? Anywhere private — a password manager is ideal. Treat it like a password.

Related

docs/integrations/chrome-extension · docs/integrations/website-embed · docs/mcp/connect · docs/account/plans

Ready to try it on your own quotes?

Start free — no credit card. 14 days of unlimited Pro, then 3 free quotes a month.

← All docs