Zum Inhalt springen
NeuSo funktioniert es

So erstellen und verwalten Sie Entwickler-API-Schlüssel in FirstSales

Erzeugen Sie API-Schlüssel mit minimalen Rechten und ressourcenspezifischen Berechtigungen, verwenden Sie sie mit der CLI und der REST-API, und rotieren oder widerrufen Sie sie sicher ohne Ausfallzeit.

Tutorials
Entwickler & CLI
Min. Lesezeit
7 min
Schritte
6 · Fortgeschritten

  1. Settings → API öffnen

    API-Schlüssel finden Sie unter Settings → API. Hier erstellen Sie die Anmeldedaten, mit denen sich die CLI und alle direkten Aufrufe an https://api.app.firstsales.io authentifizieren. Sie benötigen die entsprechende Berechtigung, um diesen Tab zu sehen.

  2. Einen Schlüssel mit minimalen Rechten erstellen

    Klicken Sie, um einen Schlüssel zu erstellen, geben Sie ihm einen Namen (etwas, das zeigt, wo er verwendet wird, z. B. „ci-contact-sync"), und aktivieren Sie nur die Scopes, die er benötigt. Scopes sind pro Ressource und in Lese- und Schreibrechte aufgeteilt: z. B. contacts:read, contacts:write, campaigns:read, kb:read. Es gibt einen *-Scope, der alles gewährt; vermeiden Sie ihn, außer Sie benötigen wirklich vollen Zugriff.

    Einen Schlüssel mit minimalen Rechten erstellen

  3. Den Schlüssel sofort kopieren

    Der vollständige Schlüssel wird genau einmal angezeigt: „Copy this key now. It will not be shown again." Kopieren Sie ihn direkt in Ihren Secret Store oder Passwort-Manager. Geht er verloren, können Sie ihn nicht wiederherstellen; Sie widerrufen ihn und erstellen einen neuen. Fügen Sie ihn niemals in Code, Chat oder einen Commit ein.

  4. Mit der CLI verwenden

    Exportieren Sie den Schlüssel als FIRSTSALES_API_KEY, und die CLI übernimmt ihn automatisch. Prüfen Sie mit whoami, bevor Sie etwas anderes tun:

    export FIRSTSALES_API_KEY="fs_live_..."   # from your secret store, never hardcoded
firstsales whoami --json

  5. Direkt mit der API verwenden

    Für rohes HTTP senden Sie den Schlüssel als Bearer-Token. Beginnen Sie mit whoami, um zu bestätigen, dass der Schlüssel aufgelöst wird, und um zu lesen, welche Org/Workspace er erreichen kann:

    curl -s https://api.app.firstsales.io/api/v1/whoami \
  -H "Authorization: Bearer $FIRSTSALES_API_KEY"

  6. Rotieren und widerrufen

    Jeder Schlüssel in der Liste kann widerrufen werden, und der Widerruf ist sofort und ohne Rückgängig-Funktion: jede CLI oder jeder Dienst, der ihn verwendet, schlägt beim nächsten Aufruf fehl. Zum Rotieren: den neuen Schlüssel erstellen, in Ihren Secret Store ausrollen, bestätigen, dass der neue funktioniert, dann den alten widerrufen. Widerrufen Sie sofort, wenn ein Schlüssel jemals offengelegt wird.

Profi-Tipps

  • Ein Schlüssel pro Verbraucher

    Geben Sie CI, Ihrem Laptop und jeder Integration einen eigenen benannten Schlüssel. Wird einer geleakt oder ein Dienst stillgelegt, widerrufen Sie nur diesen Schlüssel, statt alles zu brechen.

  • Minimale Rechte schlagen Bequemlichkeit

    Ein Read-only-Sync braucht kein contacts:write, und fast nichts braucht `*`. Vergeben Sie Scopes eng: ein geleakter Read-only-Schlüssel kann Ihre Daten nicht verändern.

  • Einmal kopieren, in einem Secret Manager speichern

    Der Schlüssel wird nur ein einziges Mal angezeigt. Fügen Sie ihn direkt in Ihren CI-Secret-Store oder Passwort-Manager ein: niemals in Quellcode, eine .env, die Sie versehentlich committen könnten, oder eine Chatnachricht.

  • Mit Überlappung rotieren, nicht mit Lücke

    Erstellen–Ausrollen–Verifizieren–dann-Widerrufen. Ein Widerruf, bevor der Ersatz live ist, verursacht einen Ausfall; das Überlappungsfenster hält Aufrufe während der Rotation am Laufen.

Häufig gestellte Fragen

Wo erstelle ich einen API-Schlüssel?

Settings → API. Geben Sie ihm einen Namen, aktivieren Sie die benötigten Scopes und erstellen Sie ihn. Der Schlüssel authentifiziert sowohl die CLI als auch direkte API-Aufrufe.

Was sind Scopes?

Pro-Ressource-Berechtigungen, aufgeteilt in Lesen und Schreiben: z. B. contacts:read, campaigns:write, kb:read, plus ein *, das alles gewährt. Aktivieren Sie nur, was der Verbraucher des Schlüssels benötigt.

Ich habe meinen Schlüssel verloren: kann ich ihn erneut sehen?

Nein. Der vollständige Schlüssel wird bei der Erstellung einmalig angezeigt (“It will not be shown again”). Geht er verloren, widerrufen Sie diesen Schlüssel und erstellen Sie einen neuen.

Wie nutzt die CLI den Schlüssel?

Setzen Sie ihn als Umgebungsvariable FIRSTSALES_API_KEY; die CLI liest sie automatisch. Führen Sie firstsales whoami aus, um zu bestätigen, dass es funktioniert.

Wie widerrufe ich einen Schlüssel?

Widerrufen Sie ihn in der API-Einstellungsliste. Der Widerruf ist sofort und dauerhaft: alles, was diesen Schlüssel verwendet, schlägt beim nächsten Aufruf fehl, rotieren Sie also zuerst einen Ersatz ein.

Wie sollte ich Schlüssel sicher rotieren?

Erstellen Sie den neuen Schlüssel, rollen Sie ihn aus, bestätigen Sie, dass er funktioniert, und widerrufen Sie dann den alten. Diese Überlappung vermeidet einen Ausfall. Widerrufen Sie nur sofort (ohne Überlappung), wenn ein Schlüssel offengelegt wurde.

Entwickler & CLI

Akquise, die weiterläuft, wenn du offline bist.Leads, E-Mails, Follow-ups und Antworten, erledigt.

Verbinde unbegrenzte Postfächer und lass KI-Agenten Leads finden, jede E-Mail schreiben und nachfassen. Oder sende deine eigenen Vorlagen im manuellen Modus. Ab $29/Monat.

Starte deine $1-Testphase Preise ansehen

$1 für 3 Tage · Jederzeit kündbar · Kein Vertrag

Mit KI installieren

Dein Coding-Agent richtet die FirstSales CLI und Skills für dich ein.

Prompt für 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 ↗npm: @firstsales.io/cli ↗GitHub: firstsales-skills ↗