---
title: "Send post to all active subscribers"
method: POST
path: "/lists/{listId}/posts/{postId}/send"
tags: ["Posts"]
---

# Send post to all active subscribers

`POST /lists/{listId}/posts/{postId}/send`

## Request

- Base URL: `https://api.tinysend.com/v1`
- URL: `https://api.tinysend.com/v1/lists/{listId}/posts/{postId}/send`
- Auth: HTTP bearer

Sends post to all active subscribers on the list. If sending would exceed the plan limit, returns 402 with MPP payment challenge (agents can pay inline) or upgrade URL.

## Path parameters

- `listId` string, required
- `postId` string, required

## Response `202`

Sending started

- SendResult
  - `status` string, required
  - `recipients` integer, required

## Other responses

- `402`: Payment required — plan limit exceeded. Includes WWW-Authenticate header for MPP-capable agents.

---

[API](https://skmtc.dev/tinysend/apis/tinysend-api.md) · [All operations](https://skmtc.dev/tinysend/apis/tinysend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tinysend/apis/tinysend-api/revisions/2dc68ac83332?raw)
