# FirstSales Developer Documentation

FirstSales Developer Platform exposes a versioned Developer API, the `firstsales` CLI, and agent workflow guidance for Codex, Claude Code, Gemini, Claude.ai, and MCP-aware tools.

## Core URLs

> /docs/introduction
Overview of the public Developer Platform.

> /docs/quickstart
Create a key, verify identity, and list campaigns.

> /docs/authentication
Developer API key behavior, access levels, scopes, and CLI auth order.

> /api-reference/introduction
OpenAPI-backed API Reference for `/api/v1`.

> /cli-reference/introduction
CLI install and usage overview.

> /agents/introduction
Agent-safe workflows and when to prefer API vs CLI.

## Machine-readable files

> /openapi/firstsales-public-v1.yaml
OpenAPI 3.1 contract for the public Developer API.

> /skill.md
Agent-ready operating guidance for FirstSales.

## Safety rules

Use public `/api/v1` endpoints only. Never depend on app-private, callback, tracking, unsubscribe, internal, support, or provider routes. Use idempotency keys for retryable mutations and `--confirm` for destructive CLI commands.