Newsletters
Change a draft issue
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
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
| Name | Type | What it is |
|---|---|---|
issue_idRequired | string | The issue_id newsletters_write_issue returned. Exactly 36 characters. |
subject | string | 1 to 200 characters. |
body | string | Markdown: headings, lists, links, bold, quotes, tables and https images. 1 to 100,000 characters. |
preheader | string | Up 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.
| Code | When | What to do |
|---|---|---|
not_found404 | No issue of the business has that issue_id. | Find it with newsletters_list_issues and use its issue_id. |
not_draft409 | The issue was scheduled or sent already; only a draft can change or be sent. | Write a new issue with newsletters_write_issue. |
More Newsletters tools
All 15 tools- Connect the business's email service
newsletters_connect_serviceConnects the business's own email service (Brevo, Amazon SES, Mailgun or any SMTP server), which every newsletter email goes out through.Free - Disconnect the email service
newsletters_remove_serviceDisconnects the business's email service and forgets its password; newsletters wait until one is connected again.Free - Create a newsletter
newsletters_createCreates a newsletter people join on its own page by confirming their address, sent through the business's own email service.Free - Change a newsletter
newsletters_updateRenames a newsletter or changes its description, postal address or archive.Free - List newsletters
newsletters_listThe business's newsletters with their pages and subscriber counts, and the email service they go out through.Free* - Invite people to a newsletter
newsletters_inviteEmails each person a request to confirm a subscription; only those who confirm ever get an issue.Free - List subscribers
newsletters_subscribersWho is on a newsletter, newest first: confirmed, waiting to confirm, unsubscribed, bounced or complained.Free* - Remove a subscriber
newsletters_remove_subscriberDeletes someone from a newsletter for good, with their history.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md