Start an outreach campaign
Start an outreach campaign the person approved; $0.01 per person when their first email leaves.
Free
This tool costs nothing to call.
An example
The hotel emails look right. Send them.
Your agent callsoutreach_startFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"campaign_id": "6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11"
}Use it when
Once the person saw the preview and said yes.
What it does
Start sending a campaign the person approved. Emails go within its days and hours, spread across the day and across its mailboxes, each mailbox within its daily limit; follow-ups thread under the first email and stop for anyone who replies; every email carries an unsubscribe line, and anyone who unsubscribes is never emailed again by any campaign. Each person costs $0.01 when their first email leaves, for their whole sequence and reply tracking; nobody who is never emailed costs anything. Refused until the writing check passes, with each fix named. Some countries, Germany among them, need a person's prior consent even for business email: the business answers for whom it writes to, so check with the person before you write to people there.
What comes back
campaign (as outreach_save_campaign shows it, now running), people_waiting (who gets a first email) and at_most_usd (what they can cost, $0.01 each). Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
campaign_idRequired | string | The campaign_id outreach_save_campaign answered with. Exactly 36 characters. |
The call
Over MCP, call outreach_start on https://api.conecto.chat/mcp/outreach. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/outreach_start \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_id":"6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
writing_check422 | An email does not pass the writing check. | Make each fix the message names, then start it again. |
no_mailbox409 | No mailbox of the campaign can send. | Name a ready mailbox, or connect one with outreach_connect_mailbox. |
nobody_to_email409 | Nobody in the audience can be emailed. | Choose another audience with outreach_save_campaign. |
campaign_ended409 | The campaign was stopped or has finished. | Save a new campaign. |
payment_required_for_outbound402 | The business never topped up, so its balance is free credit. | Top up once with POST /v1/topups. |
More Outreach tools
All 13 tools- Connect a mailbox for outreach
outreach_connect_mailboxA one-hour link for the owner to connect their own mailbox for outreach, typing its password on a Conecto page.Free - List outreach mailboxes
outreach_mailboxesThe business's mailboxes connected for outreach, each with its state, daily limit, what it sent today and its bounce rate; never a password.Free* - Change an outreach mailbox
outreach_update_mailboxRename an outreach mailbox, change its daily limit, pause or resume its sending, or disconnect it.Free - Save an outreach campaign
outreach_save_campaignCreate or change an outreach campaign: its mailboxes, the emails you write, the audience, a first line per person and when it sends.Free - Preview an outreach campaign
outreach_previewOne step of an outreach campaign as it will go, for real people: to, from, the subject and the text with the unsubscribe line.Free* - List outreach campaigns
outreach_campaignsThe business's outreach campaigns, newest first, each with its status and numbers.Free* - Get an outreach campaign
outreach_get_campaignAn outreach campaign with its numbers, each step's emails and replies, and its people page by page with their status.Free* - Read outreach replies
outreach_repliesThe replies to the business's outreach campaigns, newest first, with who wrote, the text and their status now.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md