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

# LeadMagic

> Connect LeadMagic to enrich profiles and find email addresses in your workflows.

## How to set up LeadMagic

### Authentication

LeadMagic uses API key authentication:

1. Sign up at [leadmagic.io](https://leadmagic.io)
2. Navigate to your API settings
3. Copy your API key
4. Paste the API key in Cargo when connecting

## LeadMagic actions

### Enrich profile

Get comprehensive profile data from an email address.

**Required fields:**

* **Email**: Person's email address

**Optional fields:**

* **Is personal email**: Indicate if this is a personal email

**Credits:** 3 credits per request

**Returns:**

* Full name
* Job title
* Company information
* Social profiles
* Location data

**Use case:** Enrich existing email contacts with additional profile data.

### Find email

Find a person's email address using their name and company.

**Required fields:**

* **First name**: Person's first name
* **Last name**: Person's last name

**Optional fields:**

* **Domain**: Company domain (recommended)
* **Company name**: Company name

**Credits:** 0.5 credits per request

**Use case:** Discover professional email addresses for prospecting.

## Credits summary

| Action         | Credits |
| -------------- | ------- |
| Find email     | 0.5     |
| Enrich profile | 3       |

## Rate limits

LeadMagic API has a rate limit of 300 requests per minute. Cargo handles rate limiting automatically.

## Best practices

* Provide company domain for better email matching
* Use enrichment to fill gaps in contact data
* Cache results to optimize credit usage
* Combine find email + enrich for complete profiles