conecto. Get started
Outreach

Preview an outreach campaign

outreach_preview · Reads only · Markdown

One step of an outreach campaign as it will go, for real people: to, from, the subject and the text with the unsubscribe line.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Show me exactly what the first hotel email looks like before anything goes out.

Your agent callsoutreach_previewFree*

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",
  "limit": 2
}
What comes back
{
  "campaign_id": "6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11",
  "step": 1,
  "people": 2,
  "emails": [
    {
      "to": "owen@hawthornehotel.example",
      "name": "Owen Price",
      "from": "Dana Halverson <dana@halversoncycle.example>",
      "mailbox_id": 4101,
      "subject": "Guest bikes for Hawthorne Hotel",
      "text": "Hi Owen,\n\nGuests at the Hawthorne Hotel already ask your front desk where to rent bikes.\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\nDana Halverson\nHalverson Cycle & Repair\n\nUnsubscribe: [their own unsubscribe link]"
    },
    {
      "to": "maya@alderstreethotel.example",
      "name": "Maya Brooks",
      "from": "Dana Halverson <dana@halversoncycle.example>",
      "mailbox_id": 4101,
      "subject": "Guest bikes for The Alder Street Hotel",
      "text": "Hi Maya,\n\nYour new rooftop bar makes the Alder Street Hotel a stop for every visitor downtown.\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\nDana Halverson\nHalverson Cycle & Repair\n\nUnsubscribe: [their own unsubscribe link]"
    }
  ],
  "writing": {
    "passed": true,
    "fixes": []
  }
}

Use it when

Before starting a campaign, to show the person the first emails.

What it does

The emails of one step as they will go, for real people of the campaign: who it goes to, from which mailbox, the subject and the text with every placeholder filled and the unsubscribe line Conecto adds (each person gets their own link, so the preview shows where it goes). Show the person the first emails before you start a campaign. Also the writing check's fixes, if any.

What comes back

campaign_id, step, people (how many the campaign emails), emails (to, name, from, mailbox_id, subject, text) and writing (passed and fixes). 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.
stepinteger1 to 5. Default: 1.
limitinteger1 to 25. Default: 3.
emailstringOne person of the campaign. Up to 254 characters.

The call

Over MCP, call outreach_preview on https://api.conecto.chat/mcp/outreach. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/outreach_preview \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id":"6f1c1b7e-4a1e-4d55-9a0b-0f7c3e9a2b11","limit":2}'

When it refuses

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

CodeWhenWhat to do
not_found404No campaign has that id, or the email is not one of its people.Use a campaign_id from outreach_campaigns.

More Outreach tools

All 13 tools

Give this to your agent.

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