Outreach

Start an outreach campaign

outreach_start · Changes data · Markdown

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.

With these arguments
{
  "campaign_id": "6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11"
}
What comes back
{
  "campaign": {
    "campaign_id": "6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11",
    "name": "Guest bikes for Portland hotels",
    "status": "running",
    "paused_reason": null,
    "mailboxes": [
      {
        "mailbox_id": 4101,
        "email": "dana@halversoncycle.example"
      }
    ],
    "steps": [
      {
        "subject": "Guest bikes for {company}",
        "text": "Hi {first_name},\n\n{first_line}\n\nWe rent city bikes to hotels in Portland and service them every week, so your front desk never deals with a flat tire. Guests ride to the waterfront in ten minutes.\n\nCould I bring two bikes by on Thursday so your staff can try them?\n\n{sender_name}\nHalverson Cycle & Repair"
      },
      {
        "subject": "",
        "text": "Hi {first_name}, the two trial bikes for {company} are still yours this month. Should I hold a pair for you?\n\n{sender_first_name}",
        "delay_days": 3
      }
    ],
    "audience": {
      "tag": "hotel"
    },
    "schedule": {
      "days": [
        "tue",
        "wed"
      ],
      "start_hour": 9,
      "end_hour": 12,
      "time_zone": "America/Los_Angeles"
    },
    "daily_limit": 30,
    "people": 2,
    "by": "Pip",
    "created_at": "2026-10-14T08:00:00+00:00",
    "started_at": "2026-10-14T08:00:00Z"
  },
  "people_waiting": 2,
  "at_most_usd": "$0.02"
}

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

NameTypeWhat it is
campaign_idRequiredstringThe 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:

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

CodeWhenWhat to do
writing_check422An email does not pass the writing check.Make each fix the message names, then start it again.
no_mailbox409No mailbox of the campaign can send.Name a ready mailbox, or connect one with outreach_connect_mailbox.
nobody_to_email409Nobody in the audience can be emailed.Choose another audience with outreach_save_campaign.
campaign_ended409The campaign was stopped or has finished.Save a new campaign.
payment_required_for_outbound402The business never topped up, so its balance is free credit.Top up once with POST /v1/topups.

Give this to your agent.

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