# Buttondown

**Canonical:** https://apis.io/providers/buttondown/  
**Website:** https://buttondown.com/  
**APIs profiled:** 30

Buttondown is an independent, bootstrapped email newsletter platform for writers, creators and developers, offering a Markdown and rich-text editor, subscriber management with tags, segments and metadata, automations, RSS-to-email, surveys, comments, paid subscriptions via Stripe with no revenue share, custom sending and hosting domains, and hosted archives. Its public REST API covers 133 operations across 29 resource areas — subscribers, emails, tags, segments, automations, webhooks, imports, exports, surveys, forms, images, snippets, prices and more — described by a live OpenAPI 3.1 document, backed by an 82-event webhook catalog, a date-based version train, idempotency keys, and a first-party CLI for syncing newsletter content to a local folder.

## Kin Score — 71.3 / 100 (exemplar)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 71.3).

| Facet | Score |
|---|---|
| Discoverability | 83.3 |
| Contract Quality | 70.4 |
| Governance | 16.7 |
| Contract Governance | 16.7 |
| Operational Transparency | 92.1 |
| Developer Ergonomics | 73.2 |
| Commercial Clarity | 73.7 |
| Access Clarity | 73.7 |

Regulatory layer — **Telecommunications**: 43.1 (matched via tags).

## Agent readiness — 54.5 (agent-native)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | documented |
| Error Semantics | verified |
| OpenAPI Examples | partial |
| Rate Limit Signal | verified |
| Event Surface Described | yes |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | yes |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (30)

- **Buttondown Accounts API** — The Accounts API from Buttondown — 1 operation(s) covering the authenticated account and its plan/feature state.
- **Buttondown Advertising Units API** — The Advertising Units API from Buttondown — 6 operation(s) covering newsletter sponsorship inventory — advertising units and the slots sold against them.
- **Buttondown API Requests API** — The API Requests API from Buttondown — 2 operation(s) covering the account's own API request log, including retained response bodies for idempotent requests.
- **Buttondown Attachments API** — The Attachments API from Buttondown — 4 operation(s) covering files attached to emails and inbox replies.
- **Buttondown Automations API** — The Automations API from Buttondown — 7 operation(s) covering triggered and scheduled email sequences, their actions, timing and analytics.
- **Buttondown Books API** — The Books API from Buttondown — 5 operation(s) covering the Bookshop.org book catalog embedded in newsletters.
- **Buttondown Bulk Actions API** — The Bulk Actions API from Buttondown — 2 operation(s) covering asynchronous mass operations over existing records.
- **Buttondown Comments API** — The Comments API from Buttondown — 5 operation(s) covering subscriber comments on emails, and their moderation state.
- **Buttondown Coupons API** — The Coupons API from Buttondown — 1 operation(s) covering Stripe coupons available to a paid newsletter.
- **Buttondown Emails API** — The Emails API from Buttondown — 11 operation(s) covering drafting, scheduling, publishing, rendering and analyzing newsletter emails.
- **Buttondown Events API** — The Events API from Buttondown — 2 operation(s) covering the unified event store that also powers webhooks.
- **Buttondown Exports API** — The Exports API from Buttondown — 3 operation(s) covering data exports of subscribers, emails and events.
- **Buttondown External Feeds API** — The External Feeds API from Buttondown — 7 operation(s) covering RSS-to-email feeds, their polling cadence and the items they produce.
- **Buttondown Forms API** — The Forms API from Buttondown — 5 operation(s) covering hosted and embeddable subscription forms.
- **Buttondown Images API** — The Images API from Buttondown — 4 operation(s) covering images hosted for use in emails and archives.
- **Buttondown Imports API** — The Imports API from Buttondown — 5 operation(s) covering bulk subscriber imports — the supported path for adding subscribers at volume.
- **Buttondown Newsletters API** — The Newsletters API from Buttondown — 7 operation(s) covering newsletter settings, branding, locale, and custom sending/hosting domain verification.
- **Buttondown Notes API** — The Notes API from Buttondown — 3 operation(s) covering internal notes attached to subscribers and team members.
- **Buttondown Ping API** — The Ping API from Buttondown — 1 operation(s) covering a connectivity and credential health check.
- **Buttondown Prices API** — The Prices API from Buttondown — 3 operation(s) covering paid-subscription pricing and products.
- **Buttondown Public API** — The Public API from Buttondown — 1 operation(s) covering the unauthenticated public archive search.
- **Buttondown Segments API** — The Segments API from Buttondown — 5 operation(s) covering saved, reusable audiences built from tag and metadata filters.
- **Buttondown Snippets API** — The Snippets API from Buttondown — 5 operation(s) covering reusable content snippets referenced from emails.
- **Buttondown Subscribers API** — The Subscribers API from Buttondown — 12 operation(s) covering subscriber lifecycle — creation, updates, tags, referrals, automations and Stripe subscriptions.
- **Buttondown Survey Responses API** — The Survey Responses API from Buttondown — 3 operation(s) covering responses collected from newsletter surveys.
- **Buttondown Surveys API** — The Surveys API from Buttondown — 5 operation(s) covering surveys embedded in emails and on the archive.
- **Buttondown Tags API** — The Tags API from Buttondown — 6 operation(s) covering subscriber tags and their analytics.
- **Buttondown Users API** — The Users API from Buttondown — 5 operation(s) covering team members on the account and their permissions.
- **Buttondown Webhooks API** — The Webhooks API from Buttondown — 7 operation(s) covering webhook registration, delivery attempts, and test fires.
- **Buttondown Newsletter Platform** — The Buttondown hosted newsletter platform provides a markdown-based composition experience, subscriber management, delivery infrastructure, analytics, monetization via paid subs...

## Agentic access (1)

- **Buttondown Agentic Access** — 133 operations · 71 acting

## Security (3)

- **Buttondown Authentication** — apiKey · 1 scheme
- **Buttondown Domain Security** — TLSv1.3 · HSTS · DMARC
- **Buttondown Vulnerability Disclosure** — security.txt · contact published

## Plans (1)

- **Buttondown Plans Pricing**

## Tags

Analytics, Automations, Email, Markdown, Newsletters, Paid Subscriptions, Software-as-a-Service, Subscribers, Webhook, Segmentation, Developer Tools, Marketing

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/buttondown/). Scores are computed from the provider's own public artifacts under a published rubric.
