> ## 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.

## 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@0.1.15
firstsales whoami --json
```

**CLI stable: [v0.1.15](https://www.npmjs.com/package/@firstsales.io/cli/v/0.1.15).** See the [CLI introduction](/cli-reference/introduction), [installation](/cli-reference/installation), and [complete command guide](/cli-reference/commands).

Use [Developer API keys](/docs/authentication) for API and CLI automation, and [OAuth grants](/agents/mcp-server) for Product MCP. Account sign-in and [Connectors](/integrations/introduction) have separate purposes: signing in identifies a user; connecting a sender authorizes an integration.

The CLI now includes campaign readiness, test-email preparation/send and launch preparation. See [campaign activation](/docs/campaign-activation) for version-bound confirmations and deployment prerequisites. GitHub, Google and email account acquisition inside the CLI, and Product MCP activation tools, remain pending; use the documented credential path for each client.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.