API workflows, errors, and agent rules

Workflows

Typical flows:

1. Verify identity — GET /me

2. List clients (agency) — GET /clients

3. Create or manage hosted lead magnets — /lead-magnets or /clients/{clientId}/lead-magnets

4. Read analytics — analytics scope

5. List leads — /leads

6. List activity — /activity

All list endpoints use limit / offset pagination (default limit generally 50, max generally 100). Use request_id when contacting support.

Errors

Error responses include a stable error.code, error.message, and request_id. Treat codes as stable; do not scrape message text for control flow.

LLM / agent non-negotiables

• Use only https://app.leadpanther.ai/api/v1

• Do not use https://api.leadpanther.ai/v1 as the app API base

• Do not invent endpoints

• Agency client work must use /clients/{clientId}/... routes

• On 403, check scope and agency grant

Docs: https://app.leadpanther.ai/docs/workflows · https://app.leadpanther.ai/docs/errors · https://app.leadpanther.ai/docs/llm-guide