Buttondown website screenshot

Buttondown

Buttondown is an independent email newsletter platform for creators and businesses, offering a markdown editor, automations, paid subscriptions, analytics, team collaboration, and a feature-complete REST API for programmatic management of subscribers, emails, newsletters, and related resources.

Buttondown publishes 5 APIs on the APIs.io network, including Emails API, Newsletters API, Subscribers API, and 2 more. Tagged areas include Analytics, Automations, Email, Markdown, and Newsletters.

Buttondown’s developer surface includes authentication, documentation, pricing, engineering blog, changelog, support, and 8 more developer resources.

43.1/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs
AnalyticsAutomationsEmailMarkdownNewslettersPaid SubscriptionsSaaSSubscribers

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 43.1/100 · developing
Contract Quality 12.5 / 25
Developer Ergonomics 5.2 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 8.9 / 13
Governance 0.0 / 12
Discoverability 6.5 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/buttondown: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Buttondown Emails API

The Emails API from Buttondown — 2 operation(s) for emails.

Buttondown Newsletters API

The Newsletters API from Buttondown — 1 operation(s) for newsletters.

Buttondown Subscribers API

The Subscribers API from Buttondown — 2 operation(s) for subscribers.

Buttondown Tags API

The Tags API from Buttondown — 2 operation(s) for tags.

Buttondown Webhooks API

The Webhooks API from Buttondown — 1 operation(s) for webhooks.

Buttondown Newsletter Platform

The Buttondown hosted newsletter platform provides a markdown-based composition experience, subscriber management, delivery infrastructure, analytics, monetization via paid subs...

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Buttondown API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Buttondown Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Buttondown Authentication

apiKey · 1 scheme

SECURITY

Buttondown Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Buttondown Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Buttondown Agentic Access

14 operations · 6 acting

14 operations · 6 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: buttondown
name: Buttondown
description: Buttondown is an independent email newsletter platform for creators and businesses, offering a markdown editor,
  automations, paid subscriptions, analytics, team collaboration, and a feature-complete REST API for programmatic management
  of subscribers, emails, newsletters, and related resources.
type: Index
kind: company
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/buttondown.png
tags:
- Analytics
- Automations
- Email
- Markdown
- Newsletters
- Paid Subscriptions
- SaaS
- Subscribers
url: https://raw.githubusercontent.com/api-evangelist/buttondown/refs/heads/main/apis.yml
created: '2026-04-23'
modified: '2026-07-25'
specificationVersion: '0.19'
apis:
- aid: buttondown:buttondown-emails-api
  name: Buttondown Emails API
  description: The Emails API from Buttondown — 2 operation(s) for emails.
  humanURL: https://docs.buttondown.com/api
  baseURL: https://api.buttondown.email/v1
  tags:
  - Emails
  properties:
  - type: OpenAPI
    url: openapi/buttondown-emails-api-openapi.yml
  - type: Documentation
    url: https://docs.buttondown.com/api
  - type: DeveloperPortal
    url: https://docs.buttondown.com/
  - type: API Keys
    url: https://buttondown.com/requests
  - type: ChangeLog
    url: https://docs.buttondown.com/changelog
  - type: StatusPage
    url: https://buttondown.statuspage.io/
- aid: buttondown:buttondown-newsletters-api
  name: Buttondown Newsletters API
  description: The Newsletters API from Buttondown — 1 operation(s) for newsletters.
  humanURL: https://docs.buttondown.com/api
  baseURL: https://api.buttondown.email/v1
  tags:
  - Newsletters
  properties:
  - type: OpenAPI
    url: openapi/buttondown-newsletters-api-openapi.yml
  - type: Documentation
    url: https://docs.buttondown.com/api
  - type: DeveloperPortal
    url: https://docs.buttondown.com/
  - type: API Keys
    url: https://buttondown.com/requests
  - type: ChangeLog
    url: https://docs.buttondown.com/changelog
  - type: StatusPage
    url: https://buttondown.statuspage.io/
- aid: buttondown:buttondown-subscribers-api
  name: Buttondown Subscribers API
  description: The Subscribers API from Buttondown — 2 operation(s) for subscribers.
  humanURL: https://docs.buttondown.com/api
  baseURL: https://api.buttondown.email/v1
  tags:
  - Subscribers
  properties:
  - type: OpenAPI
    url: openapi/buttondown-subscribers-api-openapi.yml
  - type: Documentation
    url: https://docs.buttondown.com/api
  - type: DeveloperPortal
    url: https://docs.buttondown.com/
  - type: API Keys
    url: https://buttondown.com/requests
  - type: ChangeLog
    url: https://docs.buttondown.com/changelog
  - type: StatusPage
    url: https://buttondown.statuspage.io/
- aid: buttondown:buttondown-tags-api
  name: Buttondown Tags API
  description: The Tags API from Buttondown — 2 operation(s) for tags.
  humanURL: https://docs.buttondown.com/api
  baseURL: https://api.buttondown.email/v1
  tags:
  - Tags
  properties:
  - type: OpenAPI
    url: openapi/buttondown-tags-api-openapi.yml
  - type: Documentation
    url: https://docs.buttondown.com/api
  - type: DeveloperPortal
    url: https://docs.buttondown.com/
  - type: API Keys
    url: https://buttondown.com/requests
  - type: ChangeLog
    url: https://docs.buttondown.com/changelog
  - type: StatusPage
    url: https://buttondown.statuspage.io/
- aid: buttondown:buttondown-webhooks-api
  name: Buttondown Webhooks API
  description: The Webhooks API from Buttondown — 1 operation(s) for webhooks.
  humanURL: https://docs.buttondown.com/api
  baseURL: https://api.buttondown.email/v1
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/buttondown-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.buttondown.com/api
  - type: DeveloperPortal
    url: https://docs.buttondown.com/
  - type: API Keys
    url: https://buttondown.com/requests
  - type: ChangeLog
    url: https://docs.buttondown.com/changelog
  - type: StatusPage
    url: https://buttondown.statuspage.io/
- aid: buttondown:newsletter-platform
  name: Buttondown Newsletter Platform
  description: The Buttondown hosted newsletter platform provides a markdown-based composition experience, subscriber management,
    delivery infrastructure, analytics, monetization via paid subscriptions, team collaboration, and integrations with Discord,
    Memberful, YouTube, and RSS.
  humanURL: https://buttondown.com/
  tags:
  - Analytics
  - Email
  - Markdown
  - Newsletters
  - SaaS
  properties:
  - type: Website
    url: https://buttondown.com/
  - type: Features
    url: https://buttondown.com/features
  - type: Integrations
    url: https://buttondown.com/features/integrations
  - type: Pricing
    url: https://buttondown.com/pricing
  x-features:
  - Markdown editor with personalization
  - Paid subscriptions without platform fees
  - Analytics dashboard
  - Automations and scheduling
  - Team collaboration without per-seat pricing
  - Concierge migration service
  - High deliverability and spam protection
  x-use-cases:
  - Independent creator newsletters
  - Paid subscription newsletters
  - Company and product newsletters
  - Migration from other newsletter platforms
common:
- type: AgenticAccess
  url: agentic-access/buttondown-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/buttondown-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/buttondown-domain-security.yml
- type: Authentication
  url: authentication/buttondown-authentication.yml
- type: GitHubOrganization
  url: https://github.com/buttondown
- type: LinkedIn
  url: https://www.linkedin.com/company/buttondown
- type: Website
  url: https://buttondown.com/
- type: Documentation
  url: https://docs.buttondown.com/
- type: Pricing
  url: https://buttondown.com/pricing
- type: Blog
  url: https://buttondown.com/blog
- type: StatusPage
  url: https://buttondown.statuspage.io/
- type: ChangeLog
  url: https://docs.buttondown.com/changelog
- type: Support
  url: mailto:support@buttondown.email
- type: LlmsText
  url: https://docs.buttondown.com/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com