> ## 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.

# Airscale

> Connect Airscale to find people, phone numbers, and emails in your workflows.

## How to set up Airscale

### Authentication

Airscale uses API key authentication:

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

<Note>
  **Code slugs** — integration slug: `airscale`. Actions: `findPeople`, `findPhone`, `personalEmail`, `reverseEmail`, `reversePhone`. Call them as `integrations.airscale.<action>(...)`.
</Note>

## Airscale actions

### Find people

Search for people by job title, company, location, or keywords.

**Optional fields:**

* **Job titles** / **Excluded job titles**: Job titles to search for or exclude (e.g., CEO, Founder)
* **Company domains** / **Excluded company domains**: Company domains to search for or exclude (e.g., airscale.io)
* **Company LinkedIn URLs** / **Excluded company LinkedIn URLs**: Company LinkedIn URLs to search for or exclude
* **Locations** / **Excluded locations**: Locations to search for or exclude (e.g., FR, US)
* **Keywords** / **Excluded keywords**: Keywords to search across profiles or exclude
* **Limit**: Number of results to return (1-100, default 100)

**Use case:** Build lead lists of people matching your persona at target companies.

### Find phone

Retrieve a phone number given a LinkedIn URL.

**Required fields:**

* **LinkedIn URL**: The LinkedIn profile URL to find the phone number for

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

### Find personal email

Find a personal email from a LinkedIn profile URL.

**Required fields:**

* **LinkedIn URL**: The LinkedIn profile URL to find the personal email for

**Use case:** Reach contacts on personal channels when professional email is unavailable.

### Reverse email lookup

Find and enrich a LinkedIn profile from a professional email.

**Required fields:**

* **Email**: The professional email address to look up

**Use case:** Turn inbound signups or CRM emails back into full LinkedIn profiles.

### Reverse phone lookup

Find and enrich a LinkedIn profile from a mobile number.

**Required fields:**

* **Mobile phone**: The mobile phone number to look up (include country code, e.g. +33610607076)

**Use case:** Identify who is behind a phone number captured from calls or forms.

## Best practices

* Combine **Find people** with **Find phone** or **Find personal email** to go from search to contactable leads
* Include the country code in phone numbers for reverse phone lookups
* Results are cacheable in Cargo — avoid redundant lookups for the same profile