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

# Leaving out companies and people

> Never export your customers, competitors or contacts you already have.

Exclusions apply to **every lane**. Excluded companies and people are left out before anything is bought, so they never use contacts from your plan.

<CardGroup cols={2}>
  <Card title="Companies" icon="building-2">
    By website domain or company LinkedIn page: current customers, competitors, partners, your own company.
  </Card>

  <Card title="People" icon="user-x">
    By email, email hash or LinkedIn profile: contacts already in your CRM, people who opted out with you.
  </Card>
</CardGroup>

## How it works

* Exclusions are applied when an export builds its audience, before anything is paid for.
* If someone still comes back, for example under a different email, they're dropped before they're written or counted. We keep that person's other email hashes too, so they're left out up front next time.
* Lane counts and "available now" leave exclusions out from each lane's next check. To update counts straight away, run `POST /api/v1/checks`.
* People you've already exported stay in your leads. Exclusions apply to future exports.
* For people, only a SHA-256 hash of each email or profile is kept, never the address itself.

## Companies

```bash Add companies theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://intentleads.si/api/v1/exclusions/companies \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["example.com", "https://www.example.org/about"], "linkedin": ["https://www.linkedin.com/company/example-net"]}'
```

```bash Upload a CSV theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://intentleads.si/api/v1/exclusions/companies \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @customers.csv
```

A CSV needs a domain column (`domain`, `company_domain`, `website`, `url`, …) or a company LinkedIn column, or it can be a plain list with one per line. Websites are cleaned to the bare domain: `https://www.example.com/about` becomes `example.com`.

| Call | What it does |
| - | - |
| `GET /api/v1/exclusions/companies` | List them, with `limit` and `offset`. |
| `POST /api/v1/exclusions/companies` | Add; ones already on the list are skipped. |
| `PUT /api/v1/exclusions/companies` | Replace the whole list. |
| `DELETE /api/v1/exclusions/companies` | Remove some (`?domain=example.com`, or the same body as adding), or all with `?all=true`. |

## People

```bash Add people theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://intentleads.si/api/v1/exclusions/people \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["jordan.lee@example.com"], "linkedin": ["https://www.linkedin.com/in/sam-rivera-example"]}'
```

You can send `email_sha256` instead of emails if you'd rather not send addresses: the SHA-256 of the email, trimmed and lowercased. A CSV or plain list works too: every cell that's an email, an email hash or a LinkedIn profile URL counts.

| Call | What it does |
| - | - |
| `GET /api/v1/exclusions/people` | How many hashes are held. The list can't be read back. |
| `POST /api/v1/exclusions/people` | Add. |
| `PUT /api/v1/exclusions/people` | Replace everyone. |
| `DELETE /api/v1/exclusions/people` | Remove some (`?email=…`, or the same body as adding), or all with `?all=true`. |

`GET /api/v1/exclusions` returns both counts in one call.

<Note>
  The people count is the number of hashes held: each email or profile you sent, plus other email hashes we found for the same people.
</Note>

## Limits

* Up to **100,000** companies and **50,000** people.
* Uploads up to 60 MB.

## Elsewhere

* **Dashboard:** **Company list** has "Companies to leave out" and "People to leave out" panels for pasting values.
* **CLI:** `intentleads exclusions add example.com jane@example.com`, or `--file customers.csv`. See [CLI](/cli).
* **MCP:** the `intent_add_exclusions`, `intent_remove_exclusions` and `intent_get_exclusions` tools. See [MCP](/mcp-setup).


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