This guide walks you through setting up the Beehiiv integration with Retention.com, including generating API credentials, creating suppression segments, and completing the integration setup.
Step 1: Get Your Beehiiv API Key and Publication ID
You’ll need two things from Beehiiv before setting up the integration:
your API Key and Publication ID.
Go to: https://app.beehiiv.com/login
(You can create a free account if you’re just testing.)Navigate to Settings → API
Generate a new API Key
Copy both:
Your API Key
Your Publication ID
Keep these handy — you’ll use them shortly.
Step 2: Create Segments for Automatic Suppression
Next, you’ll create two dynamic segments in Beehiiv. These are required for automatic suppression and ensure contacts stay up to date.
Go to Audience → Segments
Create two dynamic segments:
Recent Contacts (Last 24 Hours)
All Contacts
Important:
Make sure both segments are dynamic, so they automatically update every 24 hours.
Segment 1: Recent Contacts (Last 24 Hours)
Set conditions so this segment only includes contacts added in the last 24 hours.
(Use your standard “created at” or “subscribed at” logic based on your Beehiiv setup.)
Segment 2: All Contacts
Set conditions so this segment includes all contacts in your audience.
Copy Your Segment IDs
Once both segments are created:
Open each segment
Look at the URL in your browser
Copy the segment ID from the URL
You should now have:
Segment ID for Recent Contacts
Segment ID for All Contacts
Step 3: Set Up the Integration in Retention.com
Now you’re ready to connect everything.
Log in to Retention.com
Navigate to Integrations
Find and select the Beehiiv integration
Paste in:
Your API Key
Your Publication ID
Paste the two Segment IDs:
Recent Contacts segment
All Contacts segment
Step 4: Finish Setup
Complete the remaining setup steps.
Once saved, your Beehiiv integration is live and automatic suppression will run based on the segments you configured.
That’s it.