conecto. Get started
Newsletters

List issues

newsletters_list_issues · Reads only · Markdown

A newsletter's issues, newest first, optionally of one status.

Free*

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

An example

Which newsletter issues are still drafts?

Your agent callsnewsletters_list_issuesFree*

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
{
  "newsletter": "halverson-ride-notes",
  "status": "draft"
}
What comes back
{
  "issues": [
    {
      "issue_id": "d1ad3ad9-ef87-45a6-9f11-6def900e3c36",
      "number": null,
      "subject": "Winter tires are in, and our tune-up special",
      "preheader": "All-weather and studded tires, and 15% off tune-ups from October 24.",
      "status": "draft",
      "send_at": null,
      "web_url": null,
      "created_at": "2026-10-14T08:00:00+00:00",
      "finished_at": null
    }
  ]
}

Use it when

To find an issue_id, or see what was sent and what is still a draft.

What it does

A newsletter's issues, newest first.

What comes back

The issues, newest first, each with its issue_id, subject, status and dates. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
newsletterRequiredstringThe newsletter's slug (from newsletters_list) or its exact name. 1 to 120 characters.
statusstringOne of: draft,scheduled,sending,sent,failed,cancelled.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_list_issues \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"newsletter":"halverson-ride-notes","status":"draft"}'

When it refuses

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

CodeWhenWhat to do
not_found404No newsletter of the business has that slug or name.Call newsletters_list and use a slug from it.

More Newsletters tools

All 15 tools

Give this to your agent.

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