Newsletters

Remove a subscriber

newsletters_remove_subscriber · Deletes data · Markdown

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.

With these arguments
{
  "newsletter": "halverson-ride-notes",
  "email": "paul.hoffmann@example.com"
}
What comes back
{
  "removed": "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

NameTypeWhat it is
newsletterRequiredstringThe newsletter's slug (from newsletters_list) or its exact name. 1 to 120 characters.
emailRequiredstringUp to 254 characters.

The call

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

Terminal
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.

CodeWhenWhat to do
not_found404No newsletter of the business has that slug or name.Call newsletters_list and use a slug from it.
not_found404The address is not on this newsletter.Check the address with newsletters_subscribers.

Give this to your agent.

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