Remove a subscriber
Deletes someone from a newsletter for good, with their history.
Free
This tool costs nothing to call.
An example
Paul Hoffmann wants his data deleted. Take him off the newsletter for good.
Your agent callsnewsletters_remove_subscriberFree
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.
{
"newsletter": "halverson-ride-notes",
"email": "paul.hoffmann@example.com"
}Use it when
A person asks to be forgotten. People who only want no more issues unsubscribe themselves.
What it does
Delete someone from a newsletter for good, with their history (for example when they ask to be forgotten). To only stop their issues, they unsubscribe themselves.
What comes back
removed: the address. 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. |
emailRequired | string | Up to 254 characters. |
The call
Over MCP, call newsletters_remove_subscriber on https://api.conecto.chat/mcp/newsletters. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/newsletters_remove_subscriber \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"newsletter":"halverson-ride-notes","email":"paul.hoffmann@example.com"}'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. |
not_found404 | The address is not on this newsletter. | Check the address with newsletters_subscribers. |
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* - 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