Newsletters
Change a newsletter
Renames a newsletter or changes its description, postal address or archive.
Free
This tool costs nothing to call.
An example
Our address changes to 1834 SE Ash St on November 1. Put that on the newsletter.
Your agent callsnewsletters_updateFree
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",
"postal_address": "Halverson Cycle & Repair, 1834 SE Ash St, Portland, OR 97214"
}What comes back
Use it when
The newsletter's name, address or page changes.
What it does
Rename it, or change its description, postal address or archive. Give only what changes.
What comes back
The newsletter as it now is. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
newsletterRequired | string | The newsletter's slug (from newsletters_list) or its exact name. 1 to 120 characters. |
name | string | 1 to 120 characters. |
postal_address | string | 10 to 300 characters. |
description | string | Up to 500 characters. |
public_archive | boolean |
The call
Over MCP, call newsletters_update on https://api.conecto.chat/mcp/newsletters. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/newsletters_update \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"newsletter":"halverson-ride-notes","postal_address":"Halverson Cycle & Repair, 1834 SE Ash St, Portland, OR 97214"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No newsletter of the business has that slug or name. | Call newsletters_list and use a slug from it. |
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 - 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 - Write an issue
newsletters_write_issueWrites a draft issue in Markdown, to test and then send.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md