# beehiiv integration

> Newsletter publishing and audience-growth platform for creating, sending, and monetizing email newsletters.

- Authentication: apiKey

## Tools (77)

- **Add Subscription Tags**: Add tags to a subscription. Unknown tag names are created automatically.
- **Add Subscription to Automation**: Add an existing subscriber to an automation journey. Automation must have an active "Add by API" trigger.
- **Bulk Create Subscriptions**: Asynchronously import many subscribers at once; returns import_id for polling status.
- **Bulk Update Subscriptions**: Asynchronously update up to 1,000 subscriptions in one request; returns subscription_update_id for polling.
- **Bulk Update Subscription Status**: Bulk update the status of multiple subscriptions in one request.
- **Create Custom Field**: Create a custom subscriber field of the given data type.
- **Create Data Deletion Request**: Submit a GDPR-style data deletion request by email. Requires workspace-wide API key and gated feature.
- **Create Newsletter List**: Create a new newsletter list (beta).
- **Create Newsletter List Subscription**: Add a subscriber (by ID or email) to a newsletter list (beta).
- **Create Post**: Create a new post as a draft or scheduled/confirmed publication (Enterprise beta).
- **Create Segment**: Create a manual (sync) or dynamic (async) subscriber segment.
- **Create Subscription**: Add a new subscriber to a publication.
- **Create Tier**: Create a premium subscription tier with optional pricing.
- **Create Webhook**: Register a webhook endpoint for one or more event types.
- **Delete Custom Field**: Delete a custom field definition and all stored values.
- **Delete Newsletter List**: Delete a newsletter list (beta).
- **Delete Post**: Archive a confirmed post or permanently delete a draft.
- **Delete Segment**: Delete a segment. Subscribers in the segment are unaffected.
- **Delete Subscription**: Permanently delete a subscription and all associated data. Prefer Update with unsubscribe:true.
- **Delete Webhook**: Delete a webhook endpoint.
- **Get Author**: Retrieve an author by prefixed ID, full name, or first name.
- **Get Automation**: Retrieve one automation with optional stats.
- **Get Automation Journey**: Retrieve one subscriber's journey through an automation.
- **Get Bulk Subscription Update**: Retrieve status and error log for a single bulk subscription update job.
- **Get Complimentary Access**: Retrieve a single complimentary access gift.
- **Get Condition Set**: Retrieve a single condition set with optional stats.
- **Get Custom Field**: Retrieve one custom subscriber field.
- **Get Data Deletion Request**: Poll status of a single data deletion request. Requires workspace-wide API key.
- **Get Newsletter List**: Retrieve a single newsletter list.
- **Get Newsletter List Subscription**: Retrieve one newsletter-list membership record (beta).
- **Get Poll**: Retrieve one poll with optional stats and recent responses.
- **Get Post**: Retrieve a single post with optional content and stats expansion.
- **Get Post Aggregate Stats**: Aggregate email and web engagement stats across posts matching the filter.
- **Get Publication**: Retrieve a single publication by ID.
- **Get Publication Engagements**: Get time-series engagement metrics for a publication (opens, clicks) at day/week/month granularity.
- **Get Publications by Subscription Email**: Look up every workspace publication a given email is subscribed to.
- **Get Referral Program**: Get referral program milestones and rewards configuration.
- **Get Segment**: Retrieve one segment with optional most-recent stats.
- **Get Subscription by Email**: Look up a subscription by email address.
- **Get Subscription by ID**: Retrieve a subscription by its prefixed ID.
- **Get Tier**: Retrieve a single premium tier with optional stats and pricing.
- **Get Webhook**: Retrieve a single webhook endpoint.
- **Identify Workspace**: Return the workspace the current API key belongs to.
- **List Advertisement Opportunities**: List accepted advertisement opportunities for a publication.
- **List Authors**: List authors (users and guest authors) attached to a publication.
- **List Automation Emails**: List emails belonging to an automation with per-email engagement stats.
- **List Automation Journeys**: List subscriber journeys through an automation, filtered by status.
- **List Automations**: List email automations configured on a publication.
- **List Bulk Subscription Updates**: List background bulk subscription update jobs and their status.
- **List Complimentary Access**: List complimentary access gift objects on a publication.
- **List Condition Sets**: List reusable condition sets (used for dynamic content targeting).
- **List Custom Fields**: List all custom subscriber fields on a publication.
- **List Data Deletion Requests**: List all data deletion requests for a publication. Requires workspace-wide API key.
- **List Newsletter Lists**: List all newsletter lists on a publication. Newsletter Lists is in beta.
- **List Newsletter List Subscriptions**: List subscribers attached to a specific newsletter list (beta).
- **List Poll Responses**: List subscriber responses for a specific poll.
- **List Polls**: List polls on a publication with filters and expansions.
- **List Posts**: List posts for a publication with filters for audience, status, tags, and authors.
- **List Post Templates**: List post templates for a publication.
- **List Publications**: List all publications the API key has access to.
- **List Segment Member IDs**: List subscription IDs only for a segment's members (lightweight).
- **List Segment Members**: List full subscription objects for a segment's members.
- **List Segments**: List subscriber segments with filters for type and status.
- **List Subscriptions**: List subscribers for a publication with filters for tier, status, and email.
- **List Tiers**: List premium subscription tiers configured on a publication.
- **List Webhooks**: List webhook endpoints configured for a publication.
- **Recalculate Segment**: Trigger a fresh calculation of a segment's members.
- **Send Test Email**: Send a test copy of a post to one or more email addresses.
- **Update Custom Field**: Rename the display label of a custom field.
- **Update Newsletter List**: Update newsletter list name, description, slug, auto-subscribe, or status (beta).
- **Update Newsletter List Subscription**: Unsubscribe a member from a newsletter list by list-subscription ID (beta).
- **Update Newsletter List Subscription by Subscription ID**: Unsubscribe a subscriber from a newsletter list identified by the subscriber's ID (beta).
- **Update Post**: Update a post's fields (Enterprise beta). Only draft→confirmed status transitions allowed.
- **Update Subscription by Email**: Update a subscription identified by email address.
- **Update Subscription by ID**: Update tier, email, custom fields, or unsubscribe status on a single subscription.
- **Update Tier**: Update a tier's name, description, or prices.
- **Update Webhook**: Update the event types or description on an existing webhook endpoint.

## Triggers (3)

- **New Subscription in beehiiv**: Triggers when someone subscribes to your beehiiv publication. Set the Status filter to "Active" to react only to confirmed (double opt-in) subscriptions — confirmations that happen long after signup may be missed.
- **New Post Published in beehiiv**: Triggers when a post is published (sent) on your beehiiv publication. Scheduled posts fire when their publish time arrives.
- **New Poll Response in beehiiv**: Triggers when a subscriber responds to a beehiiv poll (survey) embedded in your newsletter.

## Related prompts

- [Turn beehiiv poll answers into a weekly content brief](https://www.generalinput.com/prompts/turn-beehiiv-poll-answers-into-a-weekly-content-brief.md)
- [Auto-share new beehiiv posts to LinkedIn and Slack](https://www.generalinput.com/prompts/auto-share-new-beehiiv-posts-to-linkedin-and-slack.md)
- [Monday morning beehiiv newsletter report to Sheets and Slack](https://www.generalinput.com/prompts/monday-morning-beehiiv-newsletter-report-to-sheets-and-slack.md)
- [Onboard new Stripe paid customers into beehiiv with a Slack welcome draft](https://www.generalinput.com/prompts/onboard-new-stripe-paid-customers-into-beehiiv-with-a-slack-welcome-draft.md)

Connect beehiiv in General Input: https://www.generalinput.com/apps/beehiiv