Styr Salesbase med AI-agenter (Claude, Cursor m.fl.)

Salesbase kan styres via REST API med en workspace API-nøgle. AI-agenter (Claude, Cursor, Claude Code, Windsurf m.fl.) får bedst resultater når de får den officielle Markdown-reference som kontekst, så de kender endpoints, felter og autentifikation.

Hvad agenten skal have

1. Markdown-referencen (anbefalet) eller JSON-docs
2. API-nøgle i miljøvariabel (aldrig i git eller delte chats)
3. Projektregler der peger på referencen og kræver read-only test først

Hvor finder jeg Markdown-filen?

Kilde	URL / handling
Download i appen	Indstillinger → API & Webhooks → Dokumentation → Download
Direkte URL	https://app.salesbase.dk/api/v1/docs/markdown
Download-link	https://app.salesbase.dk/api/v1/docs/markdown?download=true
JSON (alternativ)	https://app.salesbase.dk/api/v1/docs?full=true

Filen opdateres løbende fra samme registry som API-dokumentationen i appen. Den dækker integrations-endpoints (API-nøgle). Mobilapp-endpoints er ikke med.

Sektionerne Automations og Sequences i Markdown-filen dokumenterer alle triggers, actions, lookup-noder og sequence-steps med config-felter, så agenter kan bygge komplette flows via API.

Offentlig guide med eksempler: salesbase.dk/udvikler/ai-agenter

Opret API-nøgle

1. Gå til Indstillinger → API & Webhooks
2. Fanen API-nøgler
3. Klik Opret API-nøgle, giv den et navn (fx "Cursor agent")
4. Kopiér nøglen med det samme (vises kun én gang)
5. Gem i miljøvariabel, fx SALESBASE_API_KEY=sb_...

Cursor

1. Download Markdown eller brug URL ovenfor
2. Tilføj Project Rules med:
   • Link til MD-URL
   • Base URL: https://app.salesbase.dk/api/v1
   • Auth: Authorization: Bearer <API_KEY> fra miljø
   • Regel: læs referencen før nye endpoints bruges
3. Bed agenten starte med GET-kald (fx /api/v1/companies) før POST/PUT/DELETE

Claude Code

1. Opret CLAUDE.md i repo-roden med MD-URL og sikkerhedsregler
2. Sæt SALESBASE_API_KEY i .env (tilføj .env til .gitignore)
3. Bed Claude hente referencen ved opstart eller inkluder downloadet salesbase-api-docs.md i projektet

Claude Desktop og andre agenter

1. Download salesbase-api-docs.md fra appen eller MD-URL
2. Upload filen som projektviden / knowledge base
3. Gentag upload når API'et får nye endpoints
4. Kør API-kald via scripts med nøglen i miljøvariabler, ikke i chatten

Eksempel på agent-opgave

Læs https://app.salesbase.dk/api/v1/docs/markdown
Find åbne deals uden aktivitet i 14 dage.
Brug kun GET først. Vis plan før ændringer.

Sikkerhed

• Brug dedikerede nøgler til agenter og tilbagekald dem efter brug
• Del aldrig nøgler i prompts, screenshots eller offentlige repos
• Bed agenten bekræfte destructive handlinger (sletning, bulk, import)
• Respekter rate limits: 120 requests/minut og 50.000/dag pr. nøgle

Relateret

• API og webhooks overblik
• API-reference på web
• Udvikler-hub AI-agenter