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

# Introduction

> Give firmintent a LinkedIn company and persona — get back the right people.

## What firmintent does

You submit a LinkedIn company URL, slug, or numeric id plus a saved persona. firmintent scans the
team, enriches every usable roster profile, finds likely persona candidates, refreshes only that
shortlist, and returns ranked **target people**.

Jobs run **asynchronously** — minutes, not milliseconds (third-party data + LLM). The whole API is
**two calls**: submit a job, then **poll** it — the poll's `done` response carries the target
people inline. Prefer no polling? Receive a **webhook** instead.

<CardGroup cols={3}>
  <Card title="Persona-first, not title-first" icon="user-tie">
    Any employee can match your target; firmintent judges the enriched roster instead of headline keywords.
  </Card>

  <Card title="One company in, minutes out" icon="clock">
    Submit a company; results come back once resolved, enriched, and ranked.
  </Card>

  <Card title="API, webhooks, dashboard" icon="webhook">
    Pull over REST, get a callback when a job is done, or watch progress live.
  </Card>
</CardGroup>

## Authentication

Every request needs your API key in the `X-API-Key` header. Copy it from the
[dashboard](https://app.firmintent.com/dashboard). `POST /v1/jobs`
spends money, so it is never anonymous.

<Note>
  Your key is auto-created when you sign up — no setup step. Regenerate it anytime in the dashboard.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Submit your first company and read back target people.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, with an interactive playground.
  </Card>
</CardGroup>