conecto. Get started
Newsletters

Send a test of an issue

newsletters_send_test · Changes data · Markdown

Emails an issue to up to 5 addresses as subscribers will see it, marked [Test].

Free

This tool costs nothing to call.

An example

Send me and Luis a test of the October newsletter first.

Your agent callsnewsletters_send_testFree

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
{
  "issue_id": "0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40",
  "to": [
    "dana@halversoncycle.example",
    "luis@halversoncycle.example"
  ]
}
What comes back
{
  "sent_to": [
    "dana@halversoncycle.example",
    "luis@halversoncycle.example"
  ]
}

Use it when

Before sending, so the owner or a colleague can check it.

What it does

Email an issue as subscribers will see it to up to 5 addresses (the owner, a colleague), with "[Test]" before the subject, through the business's own email service. Links are not counted and nothing is numbered.

What comes back

sent_to: the addresses the test went to. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
issue_idRequiredstringThe issue_id newsletters_write_issue returned. Exactly 36 characters.
toRequiredarray of strings1 to 5 items.

The call

Over MCP, call newsletters_send_test on https://api.conecto.chat/mcp/newsletters. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_send_test \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_id":"0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40","to":["dana@halversoncycle.example","luis@halversoncycle.example"]}'

When it refuses

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

CodeWhenWhat to do
not_found404No issue of the business has that issue_id.Find it with newsletters_list_issues and use its issue_id.
no_sending_service409The business has not connected its own email service.Connect it with newsletters_connect_service (its SMTP server, login and from address).
invalid_input400An address is not an email address.Fix the address the message names.
sending_unavailable403The business cannot send newsletters right now.Do what the message says (often: top up once), then send again.
suppressed422An address bounced, complained or unsubscribed before.Remove the addresses the message lists and send again.
login_failed400The business's email service refused the login.Check the SMTP login and password (often an SMTP key, not the account password) and connect it again.
service_unreachable502The business's email service could not be reached.Check the SMTP server and port (587 or 465), then try again.
service_refused502The business's email service turned the email down, often a from address it does not allow.Allow the from address in the service, or connect it with one it allows.
service_busy503The business's email service asked to slow down.Try again in a few minutes.
refused422The business's email service will not take mail for an address.Use another address for that person.

More Newsletters tools

All 15 tools

Give this to your agent.

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