Use the Beehiiv Connection to bring Beehiiv subscriber data into BlueConic® profiles and to add BlueConic profiles to Beehiiv newsletter lists. Subscription status, tier, and engagement become part of the unified profile, and BlueConic segments can drive your Beehiiv lists without CSV exports or custom scripts.
Connection details:
Goal types: Import and export
Frequency: Batch (scheduled or manual)
Matching: Email address
Before you begin
Confirm your Beehiiv account is active.
Get your Beehiiv workspace API key. In Beehiiv, go to Settings > Workspace Settings > API.
Get your Beehiiv publication ID. In Beehiiv, go to Settings > Publication Settings.
Create profile properties as needed to store incoming data.
Note: One connection is linked to one Beehiiv publication. To work with another publication, create another connection.
Create a Beehiiv Connection
Select Connections > Add Connection.
Select the Beehiiv connection from the popup window.
Enter the name and metadata details for the connection.
Select Save.
Authenticate
On the Set up and run page, enter your Beehiiv workspace API key.
Enter your Beehiiv publication ID.
Select Save.
Note: If authentication fails, or BlueConic can't load your newsletter lists or fields, the goal pages stay disabled. Check the API key and publication ID, and try again.
Configure the import
Import subscribers from Beehiiv newsletter lists into BlueConic profiles.
Generate the import goal
Select the import goal.
(Optional) Edit the name to describe your import.
1. Select newsletter lists to import from
Select one or more Beehiiv newsletter lists. BlueConic imports the subscriptions on those lists.
(Optional) For each list, select Create BlueConic profiles to create a profile when no matching profile exists. If you don't, only subscribers with a matching profile are imported.
2. Link identifiers between Beehiiv and BlueConic
Select the BlueConic profile property that holds the email address. BlueConic matches Beehiiv subscribers to profiles on email address.
3. Map Beehiiv data to BlueConic
Select Add mapping.
Select a Beehiiv field and the BlueConic profile property it maps to. You can map:
Subscription status and tier
UTM parameters
Open and click statistics
Tags
Premium tier names
Beehiiv custom fields
(Optional) Add a data processor to transform values before they're stored.
Select Save.
Later runs refresh these values on the profile.
Configure the export
Export BlueConic profiles from a segment to Beehiiv newsletter lists.
Generate the export goal
Select the export goal.
(Optional) Edit the name to describe your export.
1. Select a BlueConic segment to export
Select the BlueConic segment whose profiles you want to export. Only identifiable profiles with a valid email address are exported.
2. Select newsletter lists to export to
Select one or more Beehiiv newsletter lists. Exported subscribers are added to these lists.
3. Link identifiers between BlueConic and Beehiiv
Select the BlueConic profile property that holds the email address. BlueConic matches profiles to Beehiiv subscriptions on email address.
4. Map BlueConic data to Beehiiv
Select Add mapping.
Map BlueConic data to the Beehiiv subscription tier and custom fields.
(Optional) Add a data processor to transform values before they're sent.
Select Save.
5. Choose how subscribers are created and removed
Create new subscribers: Creates a Beehiiv subscription for profiles that don't have one yet. New subscriptions are created with the welcome email turned off.
Remove subscribers: When a profile leaves the segment, unsubscribes that person from the selected newsletter lists. This only applies to subscribers the connection created, and only when you also create new subscribers. It doesn't delete the Beehiiv subscription.
Existing subscribers are updated with the mapped tier and custom fields and added to the selected lists. The export doesn't rewrite the full subscription.
Run the connection
Activate the goal
Select the goal you want to activate. We recommend testing import and export goals separately.
Run manually
Turn the connection On.
Select Save.
On the Set up and run page, go to Run history.
Select Run now to run all activated goals.
Run on a schedule
Select the Settings icon.
Choose how often to run: number of times per day, days of the week, days of the month, or weekday of the month.
Select the time of day if required.
Select OK, then Save.
Note: An export waits until Beehiiv finishes processing the bulk job before the profiles count as sent.
Confirm data exchanged successfully
See the total number of unique profiles imported or exported under Data exchange.
Next steps
Create and activate as many import and export goals as you need within this connection.
Use imported subscription status and engagement to build segments for your newsletter audiences.
FAQ
Does the connection sync in real time?
No. The connection runs in batches, manually or on a schedule.
How does BlueConic match subscribers to profiles?
On email address only. Profiles without a valid email address aren't exported. Subscribers without a matching profile aren't imported, unless you enable profile creation for that list.
Can one connection work with several publications?
No. Each connection is linked to one publication. You enter the publication ID directly; there's no publication picker. Create another connection for each publication.
Can I sign in to Beehiiv with OAuth?
No. The connection authenticates with a workspace API key.
Does the export send a welcome email or reactivate subscribers?
No. New subscriptions are created with the welcome email turned off. Existing subscribers aren't reactivated, and double opt-in settings stay unchanged.
What happens when a profile leaves the segment?
If the export creates subscribers and removes subscribers, the person is unsubscribed from the selected newsletter lists. The Beehiiv subscription itself isn't deleted. Subscribers the connection didn't create aren't removed.
Which profile properties does the connection create?
It creates Beehiiv Synced List IDs, plus internal tracking properties for the lists it created subscribers in and the data it already sent.