⚠️ 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!
Most platforms display the API key only once, immediately upon creation, for security reasons. If you did not record it at that time, you will need to generate a new key to continue using the API.
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" |
| {{ RH_PARTNER_NAME }} | The name of the partner who referred this subscriber. i.e. "Send & Grow" |
The video below shows how 👇