---
name: "newsletters_list"
area: "newsletters"
title: "List newsletters"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/newsletters_list"
mcp_server: "https://api.conecto.chat/mcp/newsletters"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/newsletters/newsletters_list"
---

# List newsletters (`newsletters_list`)

The business's newsletters with their pages and subscriber counts, and the email service they go out through.

This account's newsletters with their pages and subscriber counts, and the email service they go out through.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To find a newsletter's slug, how many people get it, or whether its email service works.

## Say this to your agent

> How many people get our newsletter now?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `newsletters_list` on the MCP server `https://api.conecto.chat/mcp/newsletters` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/newsletters_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "newsletters_list",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "newsletters": [
      {
        "newsletter": "Halverson Ride Notes",
        "slug": "halverson-ride-notes",
        "page_url": "https://cncto.co/n/halverson-ride-notes",
        "from": "news@halversoncycle.example",
        "description": "New bikes, group rides and news from our workshop, once a month.",
        "postal_address": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214",
        "public_archive": true,
        "subscribers": {
          "active": 3,
          "pending": 0,
          "unsubscribed": 0,
          "bounced": 0
        },
        "issues_sent": 0,
        "created_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "sending_service": {
      "host": "smtp-relay.brevo.com",
      "port": 587,
      "security": "starttls",
      "username": "8a1b2c001@smtp-brevo.com",
      "from_email": "news@halversoncycle.example",
      "per_day": 300,
      "checked_at": "2026-10-14T08:00:00+00:00",
      "last_error": null,
      "last_error_at": null,
      "paused_until": null
    }
  }
}
```

`result`: newsletters: each with its slug, name, page url, from address, postal address and subscriber counts, and sending_service: the connected service with its last error, or null.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [newsletters_connect_service](https://conecto.chat/tools/newsletters/newsletters_connect_service.md): Connects the business's own email service (Brevo, Amazon SES, Mailgun or any SMTP server), which every newsletter email goes out through. Free.
- [newsletters_remove_service](https://conecto.chat/tools/newsletters/newsletters_remove_service.md): Disconnects the business's email service and forgets its password; newsletters wait until one is connected again. Free.
- [newsletters_create](https://conecto.chat/tools/newsletters/newsletters_create.md): Creates a newsletter people join on its own page by confirming their address, sent through the business's own email service. Free.
- [newsletters_update](https://conecto.chat/tools/newsletters/newsletters_update.md): Renames a newsletter or changes its description, postal address or archive. Free.
- [newsletters_invite](https://conecto.chat/tools/newsletters/newsletters_invite.md): Emails each person a request to confirm a subscription; only those who confirm ever get an issue. Free.
- [newsletters_subscribers](https://conecto.chat/tools/newsletters/newsletters_subscribers.md): Who is on a newsletter, newest first: confirmed, waiting to confirm, unsubscribed, bounced or complained. Free up to 1,000,000 reads a month.
- [newsletters_remove_subscriber](https://conecto.chat/tools/newsletters/newsletters_remove_subscriber.md): Deletes someone from a newsletter for good, with their history. Free.
- [newsletters_write_issue](https://conecto.chat/tools/newsletters/newsletters_write_issue.md): Writes a draft issue in Markdown, to test and then send. Free.
- [newsletters_update_issue](https://conecto.chat/tools/newsletters/newsletters_update_issue.md): Changes a draft issue's subject, body or preheader. Free.
- [newsletters_send_test](https://conecto.chat/tools/newsletters/newsletters_send_test.md): Emails an issue to up to 5 addresses as subscribers will see it, marked [Test]. Free.
- [newsletters_send_issue](https://conecto.chat/tools/newsletters/newsletters_send_issue.md): Sends a draft to everyone who confirmed, now or at a set time, through the business's own email service. Free.
- [newsletters_cancel_issue](https://conecto.chat/tools/newsletters/newsletters_cancel_issue.md): Stops a scheduled issue, or one still going out; what went out already stays sent. Free.
- [newsletters_get_issue](https://conecto.chat/tools/newsletters/newsletters_get_issue.md): One issue: its text, where it stands, and once sent how many it reached, bounced, unsubscribed and clicked, link by link. Free up to 1,000,000 reads a month.
- [newsletters_list_issues](https://conecto.chat/tools/newsletters/newsletters_list_issues.md): A newsletter's issues, newest first, optionally of one status. Free up to 1,000,000 reads a month.