conecto. Get started
Prospects

Find prospects

prospects_find · Changes data · Markdown

Start a prospect search from a ready brief: the businesses that fit and the people to reach there, with their work email checked.

$0.05 per prospect found with a working email

From your agent’s balance. A call that fails costs nothing.

An example

Yes, go ahead with the 40 kitchens, that price is fine.

Your agent callsprospects_find$0.05 per prospect found with a working email

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "brief_token": "eyJ3IjoxLCJicmllZiI6eyJhdWRpZW5jZSI6IkluZGVwZW5kZW50IHJlc3RhdXJhbnRzIn19:example",
  "count": 40
}
What comes back
{
  "search_id": "7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34",
  "status": "completed",
  "summary": "40 independent restaurants and hotel kitchens in Hamburg, with a working email for the owner or the head chef.",
  "asked": 40,
  "found": 37,
  "charged_usd": "$1.85",
  "prospects": "prospects_get lists them with their contact details."
}

Use it when

Once the person agreed to the brief, the count and the price.

What it does

Start a prospect search from a brief prospects_prepare made: businesses that fit and the people to reach there, with their work email checked, from public business pages. About two minutes for 50. The reply is 202 with a call_id, which is the search's id: follow it with prospects_get, or wait for the prospects.found event. The price of every prospect asked for is held; when the search ends, only the prospects found with a working email are charged and the rest of the hold comes back. Two searches at a time, and 1,000 prospects a month. The business's Conecto inboxes never write first to the people found: write to them from the business's own mailbox, with an outreach campaign (outreach_save_campaign with the search_id as prospect_search_id).

What comes back

A 202 reply with the call_id, which is the search_id, and the amount held. When the search ends, the call holds its status (completed, stopped or failed), the count asked, how many were found with a working email, the charge, and where to read them (prospects_get). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
brief_tokenRequiredstringThe brief_token of a ready prospects_prepare. 20 to 12,000 characters.
countRequiredintegerHow many prospects to find: the count prospects_prepare proposed, or the one the person chose. 10 to 100.

The call

Over MCP, call prospects_find on https://api.conecto.chat/mcp/prospects. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/prospects_find \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brief_token":"eyJ3IjoxLCJicmllZiI6eyJhdWRpZW5jZSI6IkluZGVwZW5kZW50IHJlc3RhdXJhbnRzIn19:example","count":40}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_brief400The brief_token is not a ready brief for this business, or it is over a day old.Prepare it again with prospects_prepare.
limit_reached409Two searches are running already, or this one would pass the business's prospects a month.Wait for a search to end or stop one; for the month, ask for less or ask for more with account_request_limit.
payment_required402The business never topped up, so its balance is free credit.Top up once with POST /v1/topups, then call again.

More Prospects tools

All 7 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md