Beehiiv

1. Is Identity and Engagement supported for Beehiiv?

Yes, both Identity and Engagement are supported for Beehiiv. Identity will serve the newsletter reputation attributes (name, average open rate, average click rate etc.) while Engagement will serve the per post engagement metrics.

2. What's the authentication flow for Beehiiv?

You need to create the required API key by logging into Beehiiv elsewhere and then come back to the SDK to paste the generated API key. The account connection experience doesn't need you to enter the login information.

3. How do I fetch my Beehiiv API keys?

Beehiiv’s paid plans provide API access. The provided API keys are on a creator level (each newsletter creator brings their own API key). Each creator creates an API key for InsightIQ connection. Here is a video of how you can obtain your Beehiiv API keys. The steps are also mentioned below

Steps:

1. Login to your Beehiiv account (make sure you're on a paid plan).

2. Navigate to Settings > Integrations.

3. Scroll down to find the "API Keys" section.

4. Click on the "New Api Key" button.

5. In the drawer that opens up, add the key name as "InsightIQ" or any other suitable name to help you remember this later.

6. Click on the "Create New Key" button.

7. Copy the generated key, and save it somewhere. Keep this key safe and do not share with anyone else other than InsightIQ.

The official Beehiiv guide is also available on this link.

4. How frequently is the data for a profile updated?

For a successful connection, data is fetched once a week (every 7 days). Any frequency below that wouldn't have a significant change in the numbers to be meaningful enough.

In case there is an error in the API response from Beehiiv, we retry fetching the data again in 6 hours. If the API still gives an error, we keep retrying to fetch the data every 24 hours subsequently.

5. Can I connect multiple newsletters associated with the same Beehiiv account?

Yes. If you have multiple newsletters, a newsletter selection screen would be shown - on which you can select the newsletter you want to connect. You can repeat the same process after a successful connection and add as many newsletters as you want.