# Saleshandy

> Saleshandy is an all-in-one cold email outreach platform for B2B sales teams, agencies, and recruiters. It combines lead discovery (800M+ contacts), multi-step email sequences, AI personalization, email deliverability infrastructure, and a unified inbox — all designed to automate and scale outbound prospecting.

## Products

- [Cold Emailing](https://www.saleshandy.com/cold-emailing): Multi-step automated email sequences with follow-ups, personalization, A/B testing, and sender rotation
- [Lead Finder](https://www.saleshandy.com/lead-finder): B2B contact database with 800M+ verified contacts and 42M+ company profiles
- [AI Sequence Copilot](https://www.saleshandy.com/ai-email-sequence): AI-powered email sequence generation and personalization
- [AI Prospect Enrichment](https://www.saleshandy.com/ai-prospect-enrichment): AI-driven prospect data enrichment using templates or custom prompts
- [Email Deliverability](https://www.saleshandy.com/email-deliverability): Email warmup, sender rotation, deliverability monitoring, and spam detection
- [Inbox Placement Testing](https://www.saleshandy.com/inbox-placement): Test whether emails land in inbox, spam, or promotions across ESPs
- [Unified Inbox](https://www.saleshandy.com/unified-inbox): Centralized inbox for managing replies across all sending accounts with AI categorization
- [Saleshandy CRM](https://www.saleshandy.com/crm): Built-in CRM with Kanban boards for deal tracking
- [White Label](https://www.saleshandy.com/white-label): Agency white-label solution for reselling Saleshandy under your brand

## API

Saleshandy provides a REST API for automating sales workflows, managing prospects, sequences, and analytics programmatically.

- [API Getting Started Guide](https://docs.saleshandy.com/en/articles/8154265-saleshandy-api): How to generate API keys and connect to the Saleshandy API
- [API Reference (Swagger)](https://developer.saleshandy.com/): Full interactive API documentation with all endpoints

### Authentication

API key-based authentication. Generate keys at Settings → API Key in your Saleshandy account. Keys are shown once at creation and cannot be retrieved later.

### Base URL

`https://open-api.saleshandy.com`

### Endpoints

**Prospects**
- `POST /v1/prospects/import` — Import new prospects
- `POST /v1/prospects/verification-status` — Check email verification status
- `POST /v1/prospects/import-with-field-name` — Import prospects using field names
- `GET /v1/prospects/import-status/{requestId}` — Check import status
- `GET /v1/prospects/attribute` — Get prospect attribute value
- `GET /v1/prospects` — List all prospects (paginated)
- `PATCH /v1/prospects/status` — Update prospect status (replied, finished, paused, unsubscribed, active)
- `POST /v1/prospects/tags` — List all tags
- `POST /v1/prospects/tags/assign` — Assign tags to prospects
- `POST /v1/prospects/tags/un-assign` — Remove tags from prospects

**Sequences**
- `GET /v1/sequences` — List sequences and steps
- `PATCH /v1/sequences/update-prospect-outcome` — Update prospect outcome
- `GET /v1/sequences/{sequenceId}/email-accounts` — List email accounts in a sequence
- `POST /v1/sequences/{sequenceId}/email-accounts/add` — Add email account to sequence
- `POST /v1/sequences/{sequenceId}/email-accounts/remove` — Remove email account from sequence
- `POST /v1/sequences/prospects/import-with-field-name` — Import prospects into sequence
- `POST /v1/sequences/status` — Activate or pause sequences

**Email Accounts**
- `POST /v1/email-accounts/connect` — Connect new SMTP/IMAP email accounts
- `POST /v1/email-accounts/reconnect` — Reconnect existing accounts
- `GET /v1/email-accounts/connect/status/{requestId}` — Check connection status
- `POST /v1/email-accounts/bulk-update` — Bulk update email accounts
- `POST /v1/email-accounts` — List all email accounts

**Analytics**
- `POST /v1/analytics/consolidated-stats` — Engagement statistics across sequences
- `POST /v1/analytics/stats` — Statistics for a specific sequence
- `POST /v1/analytics/emailaccount/stats` — Statistics for a specific email account
- `POST /v1/analytics/team/stats` — Team report statistics

**Do-Not-Contact (DNC)**
- `POST /v1/dnc` — Add domains or emails to a DNC list
- `GET /v1/dnc` — List all DNC lists
- `GET /v1/dnc/item/search` — Search DNC items across all lists
- `GET /v1/dnc/{dncListId}` — Get items in a specific DNC list

**Fields**
- `GET /v1/fields` — List all custom fields

**Clients**
- `GET /v1/clients` — List all clients

## MCP (Model Context Protocol)

Saleshandy provides an MCP server that lets AI assistants (Claude, Cursor, VS Code, n8n) interact with the Saleshandy platform through natural conversation.

- [MCP Setup Guide](https://docs.saleshandy.com/en/articles/13367892-saleshandy-mcp-model-context-protocol): Complete guide for connecting AI assistants to Saleshandy via MCP

### MCP Endpoint

`https://mcp.saleshandy.com/mcp/{YOUR_API_KEY}`

### Transport

Streamable HTTP (native) or stdio (via mcp-remote bridge for VS Code/Cursor)

### MCP Capabilities

- **Sequences & Campaigns**: Create, activate, pause, clone multi-step email sequences and adjust sending parameters
- **Prospect Management**: Bulk import, tag, segment, and transfer prospects between sequences
- **Analytics & Insights**: Access engagement metrics (opens, clicks, replies, bounces) and compare sequence performance
- **Email Accounts**: Monitor sender accounts, warmup progress, health scores, and deliverability

### Quick Setup (Claude Desktop)

Settings → Connectors → Add custom connector → Name: "Saleshandy" → URL: `https://mcp.saleshandy.com/mcp/YOUR_API_KEY`

## CLI

Saleshandy provides an official command-line interface for managing prospects, sequences, email accounts, tasks, analytics, and more from the terminal.

- [npm Package](https://www.npmjs.com/package/@saleshandy/saleshandy-cli)
- [GitHub Repository](https://github.com/saleshandy/saleshandy-cli)

### Install

```sh
npm install -g @saleshandy/saleshandy-cli
```

Requires Node.js 18 or later.

### Authentication

```sh
# Interactive login
saleshandy auth login

# Non-interactive
saleshandy auth login --api-key YOUR_API_KEY

# Named profiles for multiple accounts
saleshandy auth login --api-key KEY --profile client-a
saleshandy auth switch client-a
saleshandy auth status

# Environment variable (useful for CI/CD)
export SALESHANDY_API_KEY=your_key
```

Precedence: `--api-key` flag > `SALESHANDY_API_KEY` env var > saved profile.

### Output Formats

Every command supports `--json`, `--csv`, and table (default) output. Use `--no-color` to disable colored output.

```sh
saleshandy prospects list --json | jq '.[].email'
saleshandy prospects list --csv > contacts.csv
```

### Command Topics

- `saleshandy auth` — Manage authentication and API key profiles
- `saleshandy prospects` — Manage prospects (import, list, tags, status)
- `saleshandy sequences` — Manage sequences and their settings
- `saleshandy email-accounts` — Manage sending email accounts
- `saleshandy enrichment` — Enrich contacts and companies (Lead Finder)
- `saleshandy unified-inbox` — Manage unified inbox emails and outcomes
- `saleshandy analytics` — Access analytics and stats reports
- `saleshandy tasks` — Manage tasks (snooze, skip, complete)
- `saleshandy dnc` — Manage Do-Not-Contact lists
- `saleshandy fields` — Manage prospect fields
- `saleshandy clients` — Manage clients and resource assignments
- `saleshandy user` — User and team information
- `saleshandy warmup` — Email warmup reports

### Common Patterns

```sh
# List and paginate
saleshandy prospects list --limit 50 --page 2

# Import prospects from JSON
saleshandy prospects import --file prospects.json

# Check async operation status
saleshandy prospects import-status REQUEST_ID

# Enrich contacts via Lead Finder
saleshandy enrichment contact --linkedin-urls "https://linkedin.com/in/person"
saleshandy enrichment contact --file contacts.json --reveal-phone

# Reply to inbox emails
saleshandy unified-inbox emails reply \
  --thread-id ID --email-id ID \
  --to "john@acme.com" --content "Thanks for reaching out!"

# Get sequence analytics
saleshandy analytics sequence-stats --sequence-id ID
```

### Global Flags

| Flag | Description |
|------|-------------|
| `--json` | Output as JSON |
| `--csv` | Output as CSV |
| `--profile <name>` | Use a named auth profile |
| `--api-key <key>` | Override API key for this command |
| `--no-color` | Disable colored output |
| `--help` | Show help |

### Shell Autocomplete

```sh
saleshandy autocomplete
```

Supports bash, zsh, and fish.

## Solutions

- [Outbound Sales Teams](https://www.saleshandy.com/use-cases/outbound-sales): Cold outreach automation for B2B sales
- [Recruitment Agencies](https://www.saleshandy.com/industries/recruitment-agencies): Automated candidate outreach for recruiters
- [SaaS Companies](https://www.saleshandy.com/industries/saas): Lead generation and outreach for SaaS
- [IT Services](https://www.saleshandy.com/industries/it-services): Client acquisition for IT service providers

## Documentation & Support

- [Help Center](https://docs.saleshandy.com): Full product documentation and guides
- [Pricing](https://www.saleshandy.com/pricing): Plans and pricing information
- [Book a Demo](https://www.saleshandy.com/demo): Schedule a product walkthrough

## Integrations

Native integrations with Pipedrive, HubSpot, Salesforce, Zoho CRM, and Zapier. API available for custom integrations.

## Optional

- [Case Studies](https://www.saleshandy.com/case-studies): Case studies and success stories
- [About Us](https://www.saleshandy.com/about-us): Company information
- [Contact](https://www.saleshandy.com/contact): Contact sales or support
- [Privacy Policy](https://www.saleshandy.com/privacy-policy): Data privacy and GDPR compliance
- [Terms of Service](https://www.saleshandy.com/terms): Terms and conditions
- [Compare vs Instantly](https://www.saleshandy.com/comparisons/instantly-alternative): Feature comparison with Instantly
- [Compare vs Smartlead](https://www.saleshandy.com/comparisons/smartlead-alternative): Feature comparison with Smartlead
- [Compare vs Apollo](https://www.saleshandy.com/comparisons/apollo-alternative): Feature comparison with Apollo.io
- [Compare vs Lemlist](https://www.saleshandy.com/comparisons/lemlist-alternative): Feature comparison with Lemlist
- [Compare vs Woodpecker](https://www.saleshandy.com/comparisons/woodpecker-alternative): Feature comparison with Woodpecker
- [Compare vs Cognism](https://www.saleshandy.com/comparisons/cognism-alternative): Feature comparison with Cognism
- [Compare vs Uplead](https://www.saleshandy.com/comparisons/uplead-alternative): Feature comparison with Uplead