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

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# Cleon1

> Connect Cleon1 to find direct phone numbers in your workflows.

## How to set up Cleon1

### Authentication

Cleon1 uses API key authentication:

1. Sign up at [cleon1.com](https://cleon1.com)
2. Copy your API key from your Cleon1 dashboard
3. Paste the API key in Cargo when connecting

Cleon1 is also compatible with Cargo credits: if you don't connect your own account, actions run on Cargo's managed Cleon1 access.

<Note>
  **Code slugs** — integration slug: `cleon1`. Actions: `findPhoneFromLinkedin`, `findPhone`. Call them as `integrations.cleon1.<action>(...)`.
</Note>

Cargo spreads requests at up to 10 calls per second against the Cleon1 API.

## Cleon1 actions

### Find phone from LinkedIn

Find a person's direct phone number from their LinkedIn profile URL.

**Required fields:**

* `linkedinUrl`: The person's LinkedIn profile URL

Returns the direct phone number along with the person's name, company name, company domain, LinkedIn URL, and your remaining Cleon1 credits.

**Use case:** Get direct dials for prospects you already have LinkedIn profiles for.

### Find phone

Find a person's direct phone number from their name and company.

**Required fields:**

* `firstName`: Person's first name
* `lastName`: Person's last name

**Optional fields:**

* `companyName`: Name of the company the person works at
* `companyDomain`: Domain of the company

**Use case:** Look up phone numbers when you have a name and company but no LinkedIn URL.

## Best practices

* Prefer **Find phone from LinkedIn** when a LinkedIn URL is available — it's the most reliable identifier
* Add a company name or domain to name-based lookups to improve matching
* Results are cacheable in Cargo — avoid redundant lookups for the same person