Newsletters

Change a draft issue

newsletters_update_issue · Changes data · Markdown

Changes a draft issue's subject, body or preheader.

Free

This tool costs nothing to call.

An example

Change the October issue's subject to "Tune-up special: 15% off from Saturday".

Your agent callsnewsletters_update_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",
  "subject": "Tune-up special: 15% off from Saturday"
}
What comes back
{
  "issue": {
    "issue_id": "0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40",
    "number": null,
    "subject": "Tune-up special: 15% off from Saturday",
    "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

A draft needs a fix before it goes out.

What it does

Change a draft's subject, body or preheader. Give only what changes.

What comes back

The issue as it now is. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
issue_idRequiredstringThe issue_id newsletters_write_issue returned. Exactly 36 characters.
subjectstring1 to 200 characters.
bodystringMarkdown: headings, lists, links, bold, quotes, tables and https images. 1 to 100,000 characters.
preheaderstringUp to 200 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_update_issue \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_id":"0c6e2a9f-4d1b-4e8a-9b3c-7f5d2e1a8c40","subject":"Tune-up special: 15% off from Saturday"}'

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.
not_draft409The issue was scheduled or sent already; only a draft can change or be sent.Write a new issue with newsletters_write_issue.

Give this to your agent.

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