mailexodus
home/migrations/from Beehiiv
// migrate from

leave Beehiiv. keep the work.

mailexodus reads Beehiiv over its API and normalizes subscribers, lists, segments, tags into one portable schema — so you move with a report, not a 40-item checklist.

agentUse mailexodus skill: Beehiiv → Sequenzy playbook
// try it

see what moves out of Beehiiv.

A live route check, computed from Beehiiv's real API surface. Pick any destination to compare import support — nothing is written.

analyzing Beehiiv…
source modePartial automated adapter
source exports6
Mailchimp imports8
destination gapsautomations
data leaves machineno · dry-run
$npx mailexodus@latest migrate --from beehiiv --to mailchimp --dry-run
agentUse mailexodus skill: Beehiiv → Mailchimp playbook
running…open the Beehiiv migration guide →
// why teams leave

why teams leave Beehiiv.

  • →
    Beehiiv migrations need an explicit boundary around what the API exposes.
  • →
    Teams want a dry-run report before rebuilding subscribers, lists, segments, tags.
  • →
    Automation email content can be partial
// transfer boundary

what mailexodus pulls from Beehiiv.

can migrate
  • +
    subscribers
  • +
    lists
  • +
    tags
  • +
    segments
  • +
    custom fields
  • +
    campaigns
needs review
  • ?
    segments
  • ?
    campaigns
cannot migrate
  • x
    suppressions
  • x
    templates
  • x
    automations
  • x
    sender reputation and domain warmup
  • x
    historical analytics, revenue attribution, and aggregate reporting
  • x
    contacts already mid-flight inside active automations
  • x
    A/B test results and provider-specific experiment history
  • x
    provider-native design blocks, product widgets, coupons, and private assets that are not exposed by API
source adapter

Partial automated adapter

Subscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content

Automation email content can be partial

// the playbook

how an agent migrates Beehiiv → Sequenzy.

This is exactly what mailexodus hands your agent: authenticate, then for each object type — read it from Beehiiv, map it to the portable schema, write it to the destination. mailexodus never writes; your agent does, with this report in hand.

01 · authenticate

Create a beehiiv API key with read access to publications, subscriptions, newsletter lists, segments, custom fields, and posts. Paste PUBLICATION_ID|API_KEY, or JSON with publicationId and apiKey

01subscribersmigrates
readGET /v2/publications/{publication_id}/subscriptions (Read subscribers from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePOST add_subscriber (Write or stage subscribers in Sequenzy.) PATCH update_subscriber (Write or stage subscribers in Sequenzy.)
02listsmigrates
readGET /v2/publications/{publication_id}/subscription_tags (Read lists from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePOST create_list (Write or stage lists in Sequenzy.) POST add_subscribers_to_list (Write or stage lists in Sequenzy.)
03tagsmigrates
readGET /v2/publications/{publication_id}/subscription_tags (Read tags from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePOST create_tag (Write or stage tags in Sequenzy.)
04segmentsneeds review
readGET /v2/publications/{publication_id}/segments (Read segments from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePOST create_segment (Write or stage segments in Sequenzy.)
05custom fieldsmigrates
readGET /v2/publications/{publication_id}/custom_fields (Read custom fields from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePATCH update_subscriber.customAttributes (Write or stage custom fields in Sequenzy.)
06campaignsneeds review
readGET /v2/publications/{publication_id}/posts (Read campaigns from Beehiiv.)
mapSubscriptions map to subscribers. Newsletter lists map to lists. Segments map to segments. Posts map to campaign content mailexodus renders normalized provider data into destination subscribers, lists, segments, campaigns, sequences, and review notes.
writePOST create_campaign (Write or stage campaigns in Sequenzy.)
stays behind
  • suppressions
  • templates
  • automations
  • sender reputation and domain warmup
  • historical analytics, revenue attribution, and aggregate reporting
  • contacts already mid-flight inside active automations
guardrails
  • Sender reputation is earned at the destination — set up SPF/DKIM/DMARC and a warmup ramp; it does not transfer.
  • Keep the source platform active until authentication, warmup, and in-flight automations have finished.
  • Honor suppressions before the first send.
  • After writing, verify counts per object type against the source before switching live sends.
// run it

guide your agent, or follow it yourself.

Pull the full playbook from the skill prompt, CLI, or MCP server, then work the steps. Start by confirming credentials: Create a beehiiv API key with read access to publications, subscriptions, newsletter lists, segments, custom fields, and posts. Paste PUBLICATION_ID|API_KEY, or JSON with publicationId and apiKey

inspect

provider coverage

npx mailexodus@latest info beehiiv

guide

agent playbook

npx mailexodus@latest guide --from beehiiv --to sequenzy

agentUse mailexodus skill: Beehiiv → Sequenzy playbook
compare Beehiiv alternatives →browse every migration page →