conecto. Get started
Newsletters

List newsletters

newsletters_list · Reads only · Markdown

The business's newsletters with their pages and subscriber counts, and the email service they go out through.

Free*

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

An example

How many people get our newsletter now?

Your agent callsnewsletters_listFree*

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
{}
What comes back
{
  "newsletters": [
    {
      "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": 3,
        "pending": 0,
        "unsubscribed": 0,
        "bounced": 0
      },
      "issues_sent": 0,
      "created_at": "2026-10-14T08:00:00+00:00"
    }
  ],
  "sending_service": {
    "host": "smtp-relay.brevo.com",
    "port": 587,
    "security": "starttls",
    "username": "8a1b2c001@smtp-brevo.com",
    "from_email": "news@halversoncycle.example",
    "per_day": 300,
    "checked_at": "2026-10-14T08:00:00+00:00",
    "last_error": null,
    "last_error_at": null,
    "paused_until": null
  }
}

Use it when

To find a newsletter's slug, how many people get it, or whether its email service works.

What it does

This account's newsletters with their pages and subscriber counts, and the email service they go out through.

What comes back

newsletters: each with its slug, name, page url, from address, postal address and subscriber counts, and sending_service: the connected service with its last error, or null. Every reply also carries cost_usd and balance_usd.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Newsletters tools

All 15 tools

Give this to your agent.

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