---
title: "Saleshandy API: pricing, rate limits & MCP | ONEGTMLAB"
description: "Saleshandy API: Cold-email sequencer bundled with the Lead Finder B2B database (852M+ contacts, 9-provider waterfall), with unlimited mailboxes, a REST…"
canonical: https://www.onegtmlab.dev/tool-directory/sending/saleshandy
---

# Saleshandy API: pricing, rate limits & MCP | ONEGTMLAB

[](/)

[

Book a call

](/book)

![](/_astro/saleshandy.CJlsyHxQ_18c1sn.webp)

API review

# Saleshandy API review

Cold-email sequencer bundled with the Lead Finder B2B database (852M+ contacts, 9-provider waterfall), with unlimited mailboxes, a REST API on every plan, an official MCP server and a CLI. Best for budget all-in-one: sending + verified contact data on one plan.

Verified 25 Oct 2026 · 115 endpoints listed · Official MCP server

[

See pricing

](#pricing)[

Saleshandy API docs

](https://developer.saleshandy.com/api-reference/introduction)

At a glance

Category

Sending, Sourcing, Enrichment

Pricing model

Flat monthly plans

Free tier

7-day free trial, no credit card, trial sending capped at 100 emails

Entry price

$34/mo, billed annually Starter

Auth

API key

Official MCP

Yes

Best for

Budget all-in-one: sending + verified contact data on one plan

[saleshandy.com ↗](https://www.saleshandy.com)[Pricing page ↗](https://www.saleshandy.com/pricing.md)

## What a call costs

The actions you pay for, as Saleshandy prices them.

Action

Cost

Per

Reveal verified work email

1

Lead Finder credit

Reveal verified mobile phone

6

Lead Finder credits (7 with email)

Enrich one company (POST /v1/enrich/company)

0.1

Lead Finder credit per company (measured: creditsCharged 0.1, balance 50 → 49.9)

Lead Finder credit top-up

$13 / $25 / $50 / $100 / $180 / $320 / $800 / $1,600

500 / 1k / 2.5k / 5k / 10k / 20k / 50k / 100k credits

## Pricing, plan by plan

US dollars, as Saleshandy's pricing page shows them on 25 Oct 2026. Monthly and annual billing are shown apart.

Free tier 7-day free trial, no credit card, trial sending capped at 100 emails; the trial account shows 50 Lead Finder credits and 2,000 active prospects (in-app Billing, our trial 2026-10-25)

### Starter

$41/mo

billed monthly

$34/mo

billed annually

1 user, 2,000 active prospects, 6,000 emails/mo, 1,500 Lead Finder credits/mo

API includedPlan details

Lead Finder top-ups from $13/500 credits

### Pro

$99/mo

billed monthly

$76/mo

billed annually

10 users, 30,000 active prospects, 100,000 emails/mo, 4,000 Lead Finder credits/mo; adds webhooks, CRM and no-code integrations

API includedPlan details

top-up packs

### Scale 200K

$189/mo

billed monthly

$149/mo

billed annually

unlimited users and active prospects, 200,000 emails/mo, 8,000 Lead Finder credits/mo, white-label

API includedPlan details

300K emails $299/$239; 600K $599/$479; custom = sales

## Rate limits

Docs publish no numeric REST limit ('fair usage limits').

More on limitsLess

Live REST responses on our trial carried x-ratelimit-limit: 20 with x-ratelimit-reset on the next minute boundary, plus x-ratelimit-global-limit: 300 (window not stated). Enrichment has separate per-account per-minute/hour/day limits readable via GET /v1/enrich/rate-limits: our trial returned 60/min, 3,000/hour, 50,000/day (the spec example shows 30 / 1,000 / 10,000). Sending limits are per mailbox (daily sending limit settings).

## How to get an API key

Saleshandy uses API key. The steps below follow Saleshandy's own docs.

1.  Create a Saleshandy account. API access starts on the Starter plan.
2.  my.saleshandy.com -> Settings -> API Key -> Create API Key (shown once; label with letters, numbers, hyphens).
3.  Send it with every request: header (x-api-key).
4.  Make a first call: To import new prospects. Keep the key in an environment variable, never in the command.
    
    ```
    curl -X POST "https://open-api.saleshandy.com/v1/prospects/import" \
      -H "x-api-key: $SALESHANDY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{}'
    ```
    

## Where the docs live

What

Where

Documentation

[developer.saleshandy.com/api-reference/introduction](https://developer.saleshandy.com/api-reference/introduction)

API reference

[developer.saleshandy.com/api-reference/introduction](https://developer.saleshandy.com/api-reference/introduction)

OpenAPI spec

[developer.saleshandy.com/openapi.json](https://developer.saleshandy.com/openapi.json)

llms.txt

[saleshandy.com/llms.txt](https://www.saleshandy.com/llms.txt)

Base URL

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

MCP server

`https://mcp.saleshandy.com/mcp`

SDKs

@saleshandy/saleshandy-cli (npm, official, Node 18+, multi-profile)

## Strengths and limits

### Where it fits

-   Budget all-in-one: sending + verified contact data on one plan
-   Agencies on Scale (unlimited users/teams, white-label)
-   Agent workflows via official MCP (OAuth or API key) and npm CLI
-   Leads-to-email workflows: CSV or domains in, enriched contacts into a sequence

### Where it falls short

-   Starter-plan integrations: no webhooks, Zapier/Make/n8n or CRM sync below Pro
-   High-throughput enrichment without checking the per-account enrichment rate limits
-   Teams needing a documented general REST rate limit: the docs say only 'fair usage'; live responses carry x-ratelimit-limit 20 per minute window and x-ratelimit-global-limit 300 (our trial, 2026-10-25)

### Worth knowing

-   Starter ($41) includes API and MCP but NOT webhooks, Zapier/Make/n8n or CRM integrations; those start at Pro ($99).
-   Help-centre 'Saleshandy API' article still says 'Saleshandy currently doesn't offer Webhook', which is stale: webhooks and /v1/webhook endpoints exist.
-   MCP auth differs between sources: developer docs say OAuth (or an api-key header); the help-centre article puts the API key in the URL path. Prefer OAuth/header so the key is not in a URL.
-   Lead Finder credits do not roll over; annual billing deposits the whole year up front.
-   No published general REST rate limit; live responses show x-ratelimit-limit 20 per minute window and a global 300, and enrichment limits differ by account (trial: 60/min, 3,000/h, 50,000/day vs spec example 30 / 1,000 / 10,000), so read GET /v1/enrich/rate-limits and the headers before bulk work.

4 moreShow fewer

-   Prospect import 'Bad Request: prospectList must be a valid prospect item' is fixed by setting conflictAction to addMissingFields, per support FAQ.
-   The docs give the base URL as `https://open-api.saleshandy.com/v1` while every spec path already starts with /v1; join host + spec path, never base + path, or you get /v1/v1/.
-   Enrichment POSTs return HTTP 201 with a requestId, not the 200 the OpenAPI spec documents; treat any 2xx as accepted.
-   The MCP exposes tools with no REST equivalent in the public spec (delete\_sequence, delete\_step, create\_dnc\_list).

## Who should use it

Use Saleshandy for

Budget all-in-one: sending + verified contact data on one plan

Look elsewhere for

Starter-plan integrations: no webhooks, Zapier/Make/n8n or CRM sync below Pro

## If Saleshandy is not the answer

Other Email sending tools in this directory, each with its own review.

[

![](/_astro/aimfox.Cl8sLyp7.svg)

Aimfox

LinkedIn outreach

From $40.83/moOfficial MCP

Best for multi-account LinkedIn outreach where you want to rent extra sender profiles natively.

Aimfox API review →](/tool-directory/linkedin-outreach/aimfox)[

![](/_astro/dripify.CHsfpJDs_1kJMTW.webp)

Dripify

LinkedIn outreach

From $59/moOfficial MCP

Best for solo sellers or small teams running LinkedIn + email sequences from their own accounts.

Dripify API review →](/tool-directory/linkedin-outreach/dripify)[

![](/_astro/emailbison.fVnRcAh4_Z1AVftg.webp)

EmailBison

Email sending

From $599/mo

Best for agencies and teams sending hundreds of thousands of emails a month that want dedicated IPs and no per-seat or per-lead….

EmailBison API review →](/tool-directory/sending/emailbison)

## Before you build

Four things to settle first, each read off Saleshandy's own pages.

-   **Confirm the API is on your plan**API access starts on the Starter plan. Free tier: 7-day free trial, no credit card, trial sending capped at 100 emails.
    
-   **Keep the key out of your code**API key. It is sent as: header (x-api-key).
    
-   **Design around the rate limit**Docs publish no numeric REST limit ('fair usage limits').
    
-   **Know the catch before you scale**Starter ($41) includes API and MCP but NOT webhooks, Zapier/Make/n8n or CRM integrations; those start at Pro ($99).
    

## Want us to build it for you?

Tell us what you want Saleshandy to do in your stack. We will show you how we would wire it into your data, outbound or CRM, and what we would check first.

[

Book a call

](/book)[

See case studies

](/case-studies)

Read from [saleshandy.com/pricing.md](https://www.saleshandy.com/pricing.md) and [developer.saleshandy.com/api-reference/introduction](https://developer.saleshandy.com/api-reference/introduction). Verified 25 Oct 2026.

All 115 endpointsFor developers: method, path, what it does and what it costs.

**Base URL:** `https://open-api.saleshandy.com`

**Bulk and async:** Prospect import returns a requestId to poll (GET /v1/prospects/import-status/{requestId}); enrichment max 100 per call, async with status/result endpoints.

**Webhooks:** API: POST /v1/webhook/create, GET /v1/webhook, GET /v1/webhook/{id}. Events: email sent, email opened, email link clicked, reply received, email bounced, prospect unsubscribed, prospect finished, prospect outcome changed, task created, LinkedIn task updated, call task updated, WhatsApp task updated and 2 more

Filter endpoints

115 endpoints

Method

Path

What it does

Cost

POSTasync

`/v1/prospects/import`

To import new prospects

Not stated

POST

`/v1/prospects/verification-status`

To find the verification status of given emails

Not stated

POSTasync

`/v1/prospects/import-with-field-name`

Import prospect with field name., Ensure that the field names exist in the system. You can import up to 100,000 prospects at a time, with a maximum content size of 90 MB. This can b

Not stated

GET

`/v1/prospects/import-status/{requestId}`

While importing prospect you will receive the requestId. Using that requestId you can check the status of the import process.

Not stated

GET

`/v1/prospects/attribute`

Get Prospect Long text attribute value by id

Not stated

POST

`/v1/prospects/{prospectId}/attribute`

Update prospect field values, Sets or updates the value of one or more fields on a prospect profile. To update a single field, provide fieldId and attributeValue. To update multiple fields in one request

Not stated

GET

`/v1/prospects/{prospectId}/notes`

List notes for a prospect, Returns a paginated list of notes attached to the specified prospect, along with any draft note and pagination metadata. Use the skip and take query parameters to page throug

Not stated

GET

`/v1/sequences`

To get the sequences and steps of a user

free (measured on our trial)

POST

`/v1/sequences`

Create a new sequence, Create a new sequence with a title. Optionally attach one or more sending email accounts via emailAccountIds and/or assign a schedule in the same call. Upfront valid

Not stated

PATCH

`/v1/sequences/update-prospect-outcome`

To update the prospect outcome

Not stated

GET

`/v1/sequences/{sequenceId}/email-accounts`

List of sending email account of sequence

Not stated

POST

`/v1/sequences/{sequenceId}/email-accounts/add`

Add sending email account to sequence

Not stated

POST

`/v1/sequences/{sequenceId}/email-accounts/remove`

Remove sending email account from sequence

Not stated

POST

`/v1/sequences/prospects/import-with-field-name`

Import prospect with field name in to sequence, Ensure that the field names exist in the system. You can import up to 100,000 prospects at a time, with a maximum content size of 90 MB. This can be a large

Not stated

POST

`/v1/sequences/status`

Activate or Pause sequence for selected sequences

Not stated

POST

`/v1/sequences/{sequenceId}/steps`

Create a new step for a sequence, Add a step to the sequence. A step belongs to a channel (Email, LinkedIn, Task, Call, Whatsapp) and has at least one variant (up to 26 for A/B testing on Email). Required</strong

Not stated

GET

`/v1/sequences/{sequenceId}/steps`

List all steps and variants for a sequence, Return every step in the sequence, in execution order, each with its variants and their payloads. Useful for exporting a sequence or for inspecting what will be sent.

Not stated

PATCH

`/v1/sequences/{sequenceId}/steps/{stepId}/variants/{variantId}`

Update a step variant for a sequence, Update the payload, status, taskNote, priority, assigneeId, or attachmentIds of an existing variant. The payload</co

Not stated

GET

`/v1/sequences/{sequenceId}/settings`

Get sequence settings (optionally filter by code), Return all 13 public settings for the sequence along with the full assigned schedule ( id, name, timezone, isDefault ), all four <cod

Not stated

PATCH

`/v1/sequences/{sequenceId}/settings`

Update sequence settings and/or schedule, Send a partial update, only the codes in settings\[\] are changed, the rest are preserved. Unsubscribe link (code 1) The value must contain the {{link}}

Not stated

PATCH

`/v1/sequences/{sequenceId}/priority-distribution`

Update priority distribution for a sequence, Sets how outreach emails are prioritised across the sequence steps. Pass the preset id in the request body as priorityDistributionId. Preset reference: 1</

Not stated

PATCH

`/v1/sequences/{sequenceId}/schedule`

Update the schedule assigned to a sequence, Assign a different schedule to the sequence. The schedule controls which days and time windows emails in this sequence are sent. Pass scheduleId (hashed) in the body. The response return

Not stated

POST

`/v1/sequences/{sequenceId}/steps/{stepId}/variants`

Add a new variant to an existing step, Append a variant to an existing step. Email steps support up to 26 variants (A/B…Z); other channels support a single active variant at a time. The payload shape must match the step's cha

Not stated

GET

`/v1/sequences/{sequenceId}/steps/{stepId}`

Get sequence step variants

Not stated

POST

`/v1/sequences/{sequenceId}/contacts`

Attach contacts to a sequence step

Not stated

POST

`/v1/sequences/{sequenceId}/test-email`

Send a test email for a sequence step

Not stated

POST

`/v1/sequences/{sequenceId}/verify-prospects`

Start prospect email verification for a sequence

Not stated

GET

`/v1/fields`

List all fields, Returns a list of fields defined in your account. Pass systemFields=true to include built-in system fields (such as First Name, Last Name, Email) along with your custom fields. Pass <code

Not stated

POST

`/v1/fields`

Create a custom field, Creates a new custom field that can be used to store additional information on prospect profiles. Supported field types are Text, Number, Long Text, Currency, Date, and Dropdown.

Not stated

PATCH

`/v1/fields/{fieldId}`

Update a custom field, Updates the label, fallback text, and/or tags of an existing custom field. Only custom (non-system) fields can be updated. Use the field ID returned by the GET /fields endpoint.

Not stated

GET

`/v1/prospects/tags`

to find all tags

Not stated

GET

`/v1/prospects`

Fetch all user prospects with pagination

Not stated

GET

`/v1/prospects/{contactId}/minimal/sequences`

Get minimal sequence histories for a contact

Not stated

PATCH

`/v1/prospects/status`

Change status of prospects (Mark prospect as replied, finished, paused, unsubscribed and active)

Not stated

POST

`/v1/prospects/unsubscribe`

to unsubscribe prospects

Not stated

POST

`/v1/contacts/unsubscribe`

to unsubscribe prospects

Not stated

POST

`/v1/prospects/tags/assign`

to assign tags to prospects

Not stated

POST

`/v1/prospects/tags/un-assign`

to unassign tags to prospects

Not stated

POST

`/v1/blacklist-domains`

Add a domain to the blacklist.

Not stated

POST

`/v1/dnc`

Add a domain/email(s) to the dnc list.

Not stated

[](/)

© 2026 ONEGTMLAB Private Limited. All rights reserved.

COMPANY

[

Why Us

](/#why-us)[

Process

](/#timeline)[

Blogs

](/blogs)[

About

](/about)[

Clients

](/clients)[

Free resources

](/free-resources)[

Newsletter

](/newsletter)

Services

[

GTM Engineering

](/ai-gtm-engineering)[

Account-Based Marketing

](/services/account-based-marketing)[

Paid Media

](/services/paid-media)[

Content Engineering

](/linkedin-personal-branding)[

RevOps

](/services/revops)[

SEO, AEO & GEO

](/services/seo-aeo-geo)[

All services

](/services)

![](/_astro/wordmark-3d.CMEfGdYr.svg)
