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

# Email Bison

> Connect Email Bison to create and manage leads in your cold email campaigns.

## How to set up Email Bison

### Authentication

Email Bison uses API key authentication with a dedicated instance domain:

1. Log in to your Email Bison account
2. Copy your dedicated instance URL (e.g. `https://send.acme.com`) — this is different for each account
3. Generate an API token from your Email Bison settings
4. In Cargo, create an **Email Bison** connector
5. Paste your instance URL in the **Domain** field
6. Paste your API token in the **API key** field

## Email Bison actions

### Create lead

Create a new lead in Email Bison.

**Required fields:**

* **Email**: The lead's email address
* **First name**: The lead's first name
* **Last name**: The lead's last name

**Optional fields:**

* **Title**: The lead's job title
* **Company**: The lead's company name
* **Notes**: Additional notes about the lead
* **Custom variables**: Key-value pairs for personalization

### Update lead

Update an existing lead in Email Bison.

**Required fields:**

* **Lead ID**: The ID of the lead to update
* **Email**: The lead's email address
* **First name**: The lead's first name
* **Last name**: The lead's last name

**Optional fields:**

* **Title**: The lead's job title
* **Company**: The lead's company name
* **Notes**: Additional notes about the lead
* **Custom variables**: Key-value pairs for personalization

### Upsert lead

Create a lead if it doesn't exist, or update it if it does.

**Required fields:**

* **Email**: The lead's email address
* **First name**: The lead's first name
* **Last name**: The lead's last name

**Optional fields:**

* **Title**: The lead's job title
* **Company**: The lead's company name
* **Notes**: Additional notes about the lead
* **Custom variables**: Key-value pairs for personalization

**Use case:** Sync leads from your CRM or enrichment tools into Email Bison campaigns without worrying about duplicates.

## Rate limits

Email Bison is rate-limited to 10 requests per second. Cargo automatically handles rate limiting to ensure reliable delivery.