Connections & imports

Use Connections & imports to manage the publishing and history inputs for the selected publication. The publication name appears in the page header so you can check the scope before making a change.

Overview

The page is split into three sections:

Publishing platform: connect beehiiv or Kit for the newsletter you actively publish
Past issue sources: add one or more public archives or RSS feeds to teach HeyNews from older issues
File imports: request an import from a CSV or another newsletter export

Each section shows what is already connected and gives you the relevant add or import action.

beehiiv and Kit connections are for active newsletters. A connection for another newsletter belongs in a separate HeyNews publication. Past issue sources and file imports add history to the publication you're already working in, and one publication can have several of them.

Connected accounts

For each connected platform, you'll see:

Account/publication name
Connection status
Newsletter issues imported
Latest sync result
Remove button

For beehiiv and Kit, select View past issues below the imported count to open Voice & past issues > Past issues for the same publication.

Adding connections

Click Connect in any section:

beehiiv: paste your API key, check it, and select a publication
Kit: click "Connect with Kit" and approve the connection on Kit
Past issue source: paste your public archive or RSS URL and HeyNews will find your past issues
File import: request help with a CSV or another export

If a completed archive check finds no usable issues, HeyNews says so. Check that the URL points to the newsletter's RSS feed or public issue archive, then reconnect with the correct URL.

Removing connections

Click Remove on a connected account and confirm. Stories that HeyNews already found stay in your account, but HeyNews stops checking that connection for new content.

If you want to retire an entire publication, go to Publications and archive it from there. Archived publications can be restored for 30 days. See Publication settings for details.

Returning from Kit

When you connect Kit, HeyNews sends you to Kit so you can approve access. After that, Kit brings you back to HeyNews. If it works, you'll see a success message. If not, HeyNews tells you what went wrong.