conecto. Get started
Newsletters

Create a newsletter

newsletters_create · Changes data · Markdown

Creates a newsletter people join on its own page by confirming their address, sent through the business's own email service.

Free

This tool costs nothing to call.

An example

Start a monthly newsletter called Halverson Ride Notes about new bikes, group rides and workshop news.

Your agent callsnewsletters_createFree

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
{
  "name": "Halverson Ride Notes",
  "postal_address": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214",
  "description": "New bikes, group rides and news from our workshop, once a month."
}
What comes back
{
  "newsletter": {
    "newsletter": "Halverson Ride Notes",
    "slug": "halverson-ride-notes",
    "page_url": "https://cncto.co/n/halverson-ride-notes",
    "from": "news@halversoncycle.example",
    "description": "New bikes, group rides and news from our workshop, once a month.",
    "postal_address": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214",
    "public_archive": true,
    "subscribers": {
      "active": 0,
      "pending": 0,
      "unsubscribed": 0,
      "bounced": 0
    },
    "issues_sent": 0,
    "created_at": "2026-10-14T08:00:00+00:00"
  },
  "next": "Share page_url so people can subscribe, or invite people with newsletters_invite. Then write an issue with newsletters_write_issue."
}

Use it when

The business wants to write to people who asked for it, again and again.

  • For one email to one person or a few, use email_send.

What it does

A newsletter people join on its own page (cncto.co/n/<name>) by confirming their address, like Buttondown or listmonk. Issues go out through the business's own email service (connect it first with newsletters_connect_service); every issue carries postal_address (the law in the US and the EU asks for one) and a one-click unsubscribe. Free; needs an account that has topped up once.

What comes back

The newsletter with its slug, name, page url, from address, postal address, description, archive setting and subscriber counts, and next: how to get subscribers and write the first issue. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstringe.g. "Halverson Ride Notes". 1 to 120 characters.
postal_addressRequiredstringThe business's postal address, shown at the foot of every issue. 10 to 300 characters.
descriptionstringOne or two lines on its page: what it is and how often it comes. Up to 500 characters.
public_archivebooleanShow past issues on its page. Default: true.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_create \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Halverson Ride Notes","postal_address":"Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214","description":"New bikes, group rides and news from our workshop, once a month."}'

When it refuses

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

CodeWhenWhat to do
payment_required402The business has never topped up; newsletters need one real top-up.Top up once (POST /v1/topups), then try again.
sending_paused403The business's email is paused after bounces, complaints or emails refused as cold outreach.Tell the owner. Conecto reviews the pause before sending resumes.
no_sending_service409The business has not connected its own email service.Connect it with newsletters_connect_service (its SMTP server, login and from address).
limit_reached409The business has as many newsletters as it may.Use one it already has.

More Newsletters tools

All 15 tools

Give this to your agent.

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