⚠️ Note: Currently, our Beehiiv integration only works with our Upscribe, Partner Program and Partner Network tools. This is due to limitations in Beehiiv's core functionality and API. As Beehiiv improves and reaches feature parity with "pro" ESPs, support for our Referral Program will be added too.
SparkLoop’s easy 2-click integration lets you connect SparkLoop to your Beehiiv account within seconds, no developer or complicated Zapier hacks required!
The steps for Beehiiv integration
When asked to choose your email platform, click on "Beehiiv".
You will be redirect to a page where you can enter your Beehiiv's API key and publication ID (you can find both here). You will need to be on a paid Beehiiv plan to gain API access.
First, create a new API key on Beehiiv by clicking on the "New Api Key" button. Give it a name (eg: "SparkLoop") and click "Create New Key"
⚠️ Make sure to copy your API key somewhere as you won't be able to find it after you close the sidebar!
You can find your publication ID under the "Publication ID" section. Make sure to choose the publication id for the API V2.
Paste your Beehiiv API key and Publication ID into SparkLoop and click on "Connect your Beehiiv account"
Creating custom fields in Beehiiv (optional)
Other partner newsletters in SparkLoop can recommend your publication in their Upscribe widgets for free (or paid, if you have a Partner Program). The recommended subscribers will automatically be added into your Beehiiv account.
If you want to be able to see in Beehiiv which subscribers were recommended by which partner newsletters, you need to first create several custom fields in Beehiiv:
Custom field | Merge tag | Description |
| {{ RH_SUBID }} | Subscriber's ID. |
| {{ RH_ISREF }} | Whether or not the subscriber has been referred. "YES" or "NO". |
| {{ RH_SOURCE }} | The source of the referral, ie: sparkloop-magic or sparkloop-upscribe. |
| {{ RH_PARTNER }} | The ID of the partner who referred this subscriber. ie: "partner_abc123" |
The video below shows how 👇
Rejection Segment
Beehiiv has limited API functionality that don't allow SparkLoop to be notified in real-time about unsubscribes. However, being able to tell SparkLoop when your subscribers unsubscribe is extremely important when you're running a partner program to avoid paying for unengaged referrals.
Luckily, it's very easy to circumvent this issue.
All you need to do is create a dynamic segment in Beehiiv with 3 conditions:
What the video below to learn how to set up this segment.