Connecting beehiiv to HeyNews

HeyNews connects to beehiiv so it can learn from your past issues and see which topics readers respond to.

What HeyNews does with your beehiiv data

When you connect beehiiv, HeyNews will:

  • Import your broadcast history and save the URLs you've shared with your readers so HeyNews can use them in future drafts.
  • Find more article links inside each broadcast (up to 10 per issue) and save them as stories HeyNews can use later.
  • Use links from your past broadcasts to help find recurring sources and RSS feeds for future story collection.
  • Pull broadcast performance data (open rates, click rates, unsubscribes) so HeyNews knows which topics your readers care about.
  • Notice which links get clicks so similar stories can rank higher in future suggestions.

HeyNews only reads your publication data. It will never send emails, modify your subscribers, or change anything in your beehiiv account.

How to connect

During onboarding

  1. Choose the existing creator newsletter path in onboarding
  2. When you reach newsletter connection, paste your beehiiv API key
  3. HeyNews checks it and shows your available publications
  4. Select the publication you want to connect
  5. Click Connect to finish

From HeyNews

  1. Go to Connections & imports in the sidebar
  2. Open Publishing platform and click Connect beehiiv
  3. In the connection form, paste your beehiiv API key
  4. Click Validate Key to check that it works
  5. Select your publication from the dropdown
  6. Click Connect

Your beehiiv publication will now appear under Publishing platform.

Getting your beehiiv API key

  1. Log in to your beehiiv dashboard
  2. Go to Settings > Integrations
  3. Find the API section and copy your API key
  4. Paste it into HeyNews

What happens after connecting

After you connect beehiiv, HeyNews checks for updates in the background:

  • Every 4 hours, HeyNews checks recent posts and saves article links as stories.
  • Every hour, HeyNews checks performance for posts that are at least 48 hours old.

Multi-publication support

Unlike Kit (which is one account per connection), beehiiv supports multiple publications. Each beehiiv publication is a separate connection, and each connection gets its own publication inside HeyNews automatically. If you manage several beehiiv newsletters, you can connect each one individually.

The publication name comes from your beehiiv publication settings. If it is not available right away, HeyNews shows "Unnamed Publication" until the next check finds the real name.

Disconnecting beehiiv

  1. Go to Connections & imports in the sidebar
  2. Find your beehiiv publication card
  3. Click Remove
  4. Confirm the removal

Stories HeyNews already found stay in your account, but HeyNews stops checking beehiiv for new posts.

Data and privacy

  • Your beehiiv API key is encrypted before being stored and never shown back in the app.
  • HeyNews only reads from your beehiiv account. It never sends emails, changes subscribers, or edits your content.

Need help?

If something's not working, email support@heynews.co.