Connect a mailbox for outreach
A one-hour link for the owner to connect their own mailbox for outreach, typing its password on a Conecto page.
Free
This tool costs nothing to call.
An example
I want the hotel emails to go out from my own Gmail, not from some service. Set that up.
Your agent callsoutreach_connect_mailboxFree
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.
{
"provider": "gmail"
}Use it when
Before the first campaign, or to add a mailbox that shares the sending.
- For the business's own Conecto inbox for replies and support, use
email_create_inbox.
What it does
A link for the owner to connect one of the business's own mailboxes, which outreach campaigns send from and read replies in. The owner opens it and types the mailbox's settings and password on a Conecto page naming the business; you never see the password. Gmail and Outlook connect the same way with an app password (name the provider and their servers are filled in); any other mailbox with its SMTP and IMAP settings. The link works once and for an hour. outreach.mailbox_connected tells you when it is done, and outreach_mailboxes lists it. Conecto's own inboxes never send cold email.
What comes back
link (the page for the owner, good once for an hour), expires_in_minutes and tell_the_owner, words to send with it. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
provider | string | Whose mailbox it is, to fill in its servers: gmail, outlook, or other. One of: gmail,other,outlook. Default: other. |
The call
Over MCP, call outreach_connect_mailbox on https://api.conecto.chat/mcp/outreach. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/outreach_connect_mailbox \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"gmail"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
limit_reached409 | The business has as many mailboxes connected as it may. | Disconnect one, or ask for more with account_request_limit (outreach_mailboxes). |
unavailable503 | Mailboxes can't be connected right now. | Try again later. |
More Outreach tools
All 13 tools- 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* - Start an outreach campaign
outreach_startStart an outreach campaign the person approved; $0.01 per person when their first email leaves.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