# beehiiv API Documentation

This is the complete API documentation for connecting to the beehiiv 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 **beehiiv connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

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

## beehiiv actions

- PUT `add-subscription-tag` Add Subscription Tag
- POST `bulk-create-subscriptions` Bulk Create Subscriptions
- POST `create-publication-post` Create Publication Post
- POST `create-publication-webhook` Create Publication Webhook
- POST `create-subscription` Create Subscription
- DELETE `delete-publication-post` Delete Publication Post
- DELETE `delete-publication-webhook` Delete Publication Webhook
- DELETE `delete-subscription` Delete Subscription
- GET `get-bulk-subscription-update` Get Bulk Subscription Update
- GET `get-publication` Get Publication
- GET `get-publication-email-blast` Get Publication Email Blast
- GET `get-publication-post` Get Publication Post
- GET `get-publication-post-aggregate-stats` Get Publication Post Aggregate Stats
- GET `get-publication-webhook` Get Publication Webhook
- GET `get-subscription-by-email` Get Subscription by Email
- GET `get-subscription-by-id` Get Subscription by ID
- GET `get-subscription-by-subscriber-id` Get Subscription by Subscriber ID
- GET `get-subscription-jwt-token` Get Subscription JWT Token
- GET `identify-workspace` Identify Workspace
- GET `list-bulk-subscription-updates` List Bulk Subscription Updates
- GET `list-publication-custom-fields` List Publication Custom Fields
- GET `list-publication-email-blasts` List Publication Email Blasts
- GET `list-publication-engagements` List Publication Engagements
- GET `list-publication-posts` List Publication Posts
- GET `list-publication-webhooks` List Publication Webhooks
- GET `list-publications` List Publications
- GET `list-subscriptions` List Subscriptions
- PUT `update-publication-webhook` Update Publication Webhook
- PUT `update-subscription-by-email` Update Subscription by Email
- PUT `update-subscription-by-id` Update Subscription by ID