Beehiiv

Newsletter platform with subscriber management, post publishing, automations, and referral programs. Header: Authorization: Bearer {api_key} Get key: Settings >

EmailCRO

bycoreyhaines31455 words

What is Beehiiv?

What this skill does

The Beehiiv skill enables programmatic management of newsletter publications, subscribers, posts, automations, and referral programs via Beehiiv’s REST API v2. It supports retrieving and updating subscription data, filtering by status or acquisition source, and accessing detailed post metrics like open and click rates. This skill helps marketers sync subscriber lists, automate publishing workflows, and monitor referral-driven growth without manual platform interaction.

Who it's for

This skill is designed for performance marketers managing large or segmented email audiences who need to automate subscriber lifecycle and engagement tracking. Growth leads running newsletter-driven acquisition campaigns benefit from syncing external data sources and tracking UTM parameters to optimize channels. Agency strategists implementing referral incentives or tiered subscriptions will find the post and referral program endpoints useful for integrating and measuring program impact.

Key workflows

First, practitioners authenticate using a bearer token retrieved from Beehiiv’s workspace settings, ensuring secure API access. Next, they list and filter subscriptions by status, tier, or acquisition UTM tags to identify active users or target segments for re-engagement. Then, users create or update subscriptions to onboard new contacts or move subscribers between free and premium tiers while optionally sending welcome emails. Finally, they retrieve post details and referral program stats to assess content performance and referral-driven subscriber growth, iterating on campaign adjustments with real-time data.

Common questions

How do I securely store the Beehiiv API key? The API key is only displayed once on creation in the Beehiiv dashboard, so copy and store it securely immediately. Can I batch update multiple subscriptions at once? No, the API requires individual requests per subscription update, so workflows should iterate accordingly. Is post creation available for all plans? No, creating posts via API is limited to Enterprise-level subscriptions, while listing posts is broadly available.

How to use in Metaflow

Attach this skill to a Metaflow agent task by providing your Beehiiv API key and specifying the publication ID to scope requests. Expect seamless execution of subscriber CRUD operations, post retrieval, and referral program queries with cursor-based pagination for handling large datasets. This skill enables integrating newsletter data into broader marketing workflows and automations, helping to drive measurable growth and engagement metrics.

For broader context, see our roundup of claude marketing skills, and read Claude Code workflows for marketing agencies for related setup guidance.

Related skills

Form Conversion Optimization

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form," "nobody fills out our form," "form abandonment," "too many fields," "demo request form," or "lead form isn't converting." Use this for any non-signup form tha

View →

Cold Outreach Generator

Generate cold email templates, LinkedIn messages, follow-up sequences, and value propositions tailored to specific industries that actually get responses and book discovery calls.

View →

Email Sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," or "lifecycle emails." For in-app onboarding, see onboarding-cro.

View →

Email Sequence & Drip Campaign Builder

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold out

View →

Cold Email

Generate personalized cold email sequences (7-14 emails) with A/B test subject lines, follow-up timing recommendations, and integrated social proof. Creates multi-touch campaigns optimized for response rates. Use when users need outbound email campaigns, sales sequences, or lead generation emails.

View →

Popup CRO

When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," or "overlay." For forms outside of popups, see form-cro. For general page conversion optimization, see page-cro.

View →