# Buttondown API Documentation

This is the complete API documentation for connecting to the Buttondown API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Buttondown connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/buttondown/actions/{actionSlug}/run
```

## Buttondown actions

- POST `create-draft-email` Create Draft Email
- POST `create-subscriber` Create Subscriber
- POST `create-webhook` Create Webhook
- DELETE `delete-email` Delete Email
- DELETE `delete-subscriber` Delete Subscriber
- DELETE `delete-webhook` Delete Webhook
- GET `list-emails` List Emails
- GET `list-newsletters` List Newsletters
- GET `list-subscribers` List Subscribers
- GET `list-webhook-attempts` List Webhook Attempts
- GET `list-webhooks` List Webhooks
- GET `retrieve-email` Retrieve Email
- GET `retrieve-subscriber` Retrieve Subscriber
- GET `retrieve-webhook` Retrieve Webhook
- POST `send-draft-email` Send Draft Email
- POST `test-webhook` Test Webhook
- PUT `update-draft-email` Update Draft Email
- PUT `update-subscriber` Update Subscriber
- PUT `update-webhook` Update Webhook