Get an issue

newsletters_get_issue · Reads only · Markdown

One issue: its text, where it stands, and once sent how many it reached, bounced, unsubscribed and clicked, link by link.

Free*

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

How did the September newsletter do? How many people clicked through to the bikes?

Your agent callsnewsletters_get_issueFree*

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"
}

What comes back

{
  "issue": {
    "issue_id": "0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40",
    "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,
    "body": "# Winter tires are in\n\nOur winter tires arrived this week, from all-weather commuter tires to studded ones for icy mornings. We fit them while you wait.\n\n![The Willamette 8 in green](https://halversoncycle.example/img/willamette-green.jpg)\n\n## Tune-up special\n\nFrom October 24 to 31, every tune-up is 15% off.\n\n[See the tires](https://halversoncycle.example/tires)"
  }
}

Use it when

Someone asks how an issue did, or whether it went out.

What it does

One issue: its text, where it stands (with what holds it up, if anything), and once sent how many it reached, bounced, unsubscribed and clicked, link by link.

What comes back

The issue in full: subject, body, status, problem (what holds it up, if anything), when it was sent, and the counts of sent, bounced, unsubscribed and clicked, with clicks per link. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`issue_id`Required	string	The issue_id newsletters_write_issue returned. Exactly 36 characters.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/newsletters_get_issue \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_id":"0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40"}'

When it refuses

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

Code	When	What to do
`not_found`404	No issue of the business has that issue_id.	Find it with newsletters_list_issues and use its issue_id.

More Newsletters tools

All 15 tools

Give this to your agent.

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

Get an issue

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Newsletters tools

Give this to your agent.