# Clearbit

Clearbit enrichment: person, company, combined enrich, reveal, prospector. Exposes **5 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `clearbit_person_enrich` | Enrich a person by email, name+domain, or LinkedIn URL - GET /people/find. |
| `clearbit_company_enrich` | Enrich a company by domain, name+location, LinkedIn URL, or ticker - GET /companies/find. |
| `clearbit_combined_enrich` | Enrich both person and company in a single call - GET /combined/find. |
| `clearbit_prospector_search` | Search for prospects by role, seniority, location, company, skills, etc. |
| `clearbit_reveal` | Identify company from IP address - GET /companies. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`CLEARBIT_API_KEY`** - Clearbit dashboard - API. (https://dashboard.clearbit.com/api)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CLEARBIT_API_KEY` | Clearbit dashboard - API. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Clearbit API documentation](https://dashboard.clearbit.com/docs)