> ## Documentation Index
> Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FirstSales Developer Platform

> Manage FirstSales with a versioned API, CLI, and agent-ready workflows.

FirstSales Developer Platform gives developers and AI agents a stable way to inspect and manage FirstSales without relying on private app routes.

Use the platform when you need to:

* Create and manage campaigns, contacts, inbox actions, connectors, knowledge bases, offerings, tracking domains, billing reads, members, groups, domains, and API keys.
* Run FirstSales from Codex, Claude Code, Gemini, Claude.ai, scripts, or CI.
* Use a stable public contract instead of app-private routes that can change without notice.

<Note>
  The Developer API is contract-first. Provider callbacks, tracking pixels, unsubscribe handlers, support/admin routes, and destructive account deletion flows are intentionally not public API endpoints.
</Note>

## Base URL

```text theme={null}
https://api.app.firstsales.io
```

All public endpoints live under `/api/v1`.

## First request

```bash theme={null}
curl https://api.app.firstsales.io/api/v1/whoami \
  -H "Authorization: Bearer $FIRSTSALES_API_KEY"
```

## CLI

```bash theme={null}
npm install -g @firstsales.io/cli
firstsales whoami --json
```