--- title: "API key scopes grouped and editable" description: "API key scopes are now grouped by area, every scope is on offer, and you can change a key’s scopes after you create it." canonical: "https://firstsales.io/changelog/api-key-scopes-grouped-and-editable/" --- [Improvement](/changelog/) # API key scopes grouped and editable API key scopes are now grouped by area, every scope is on offer, and you can change a key’s scopes after you create it. Published September 25, 2026 Reading time 1 min read Contents [└What changed](#what-changed)[└How to use it](#how-to-use-it)[└Why it matters](#why-it-matters) [All updates](/changelog/) Managing API keys is simpler. Scopes (what a key is allowed to do) are grouped by area, and you can now edit a key's scopes after it is made instead of deleting it and starting again. ## What changed * **Grouped scopes.** Scopes are sorted by area, such as contacts, campaigns and inbox, so you can find the one you want. * **Every scope on offer.** The picker now lists every scope the API supports, with one "select all" when you want full access. * **Edit later.** Open a key and change its scopes. The key itself stays the same, so nothing that uses it breaks. * **Correct usage counts.** The usage shown for each key now counts every call correctly. ## How to use it Go to Settings, then API. Pick a key and choose edit to change its scopes. ## Why it matters Giving a key only the access it needs is the safe way to connect other tools. Before, changing access meant a new key and updating every tool that used the old one. Now it is one edit. ## All updates * [└ Cal.com booking link connector Previous ](/changelog/cal-com-booking-link-connector/) * [└ Send an email to a contact from their page Next ](/changelog/email-a-contact-from-their-page/) ## Outreach that keeps going after you log off. Leads, emails, follow-ups and replies, handled. Connect unlimited mailboxes and let AI agents find leads, write each email and follow up. Or send your own templates in manual mode. From $29/mo. [Start your $1 trial T](https://app.firstsales.io)[See pricing](/pricing/) $1 for 3 days · Cancel anytime · No contract ## Install with AI Your coding agent sets up the FirstSales CLI and skills for you. Prompt for Claude Code I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code. Read these first so you know how FirstSales works: - Developer docs and API: https://developer.firstsales.io - CLI: https://www.npmjs.com/package/@firstsales.io/cli - Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md) Setup 1. Install the CLI: npm install -g @firstsales.io/cli 2. Install the FirstSales skills: claude plugin marketplace add firstsalesio/firstsales-skills claude plugin install firstsales@firstsales 3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up. 4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need. Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden: read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY 5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to. Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through: 1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product. 2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add. 3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own). 4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes. 5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads. 6. Inviting my team and giving each person the right access. Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email). Throughout, as you learn about my business, proactively suggest and help create: - Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them. - Campaign ideas and segments worth testing, with the reason for each. Safety rules: - Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes. - Tell me before anything that spends credits, and how many. Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options. [Developer docs ↗](https://developer.firstsales.io)[npm: @firstsales.io/cli ↗](https://www.npmjs.com/package/@firstsales.io/cli)[GitHub: firstsales-skills ↗](https://github.com/firstsalesio/firstsales-skills)