How to Connect Beehiiv

Connecting Beehiiv to Oshi lets you pay subscribers in Bitcoin for answering the polls in your newsletter. Every poll response becomes a small sats reward, which gives readers a concrete reason to open the next email and click something inside it.

The connection has two halves. First you link your Beehiiv account to Oshi with an API key. Then you build one automation inside Beehiiv that tells Oshi whenever a subscriber answers a poll. Both halves are required — Oshi cannot detect poll responses on its own.

What You'll Need

• A Beehiiv publication with polls enabled
• Access to Settings in your Beehiiv account (to copy the API key and publication ID)
• Newsletter Rewards enabled on your Oshi account — contact Oshi support if you don't see Beehiiv on your Connections page

Step 1: Get Your Beehiiv API Key

1. Log into Beehiiv
2. Go to Settings > Integrations > API
3. Create a new API key (or copy an existing one)
4. Copy the key before navigating away

Step 2: Get Your Publication ID

1. In Beehiiv, go to Settings > Publication Details
2. Copy the Publication ID — it begins with pub_

Step 3: Connect Beehiiv in Oshi

1. From your Oshi dashboard, go to Connections in the left sidebar
2. Find Beehiiv and click Connect
3. Paste your API Key and Publication ID
4. Click Connect

The modal will confirm the connection and then show the automation setup instructions for the next step. Leave this window open — you'll copy two values from it.

Step 4: Build the Automation in Beehiiv

This is the piece that tells Oshi a subscriber answered a poll.

1. In Beehiiv, create a new Automation
2. Set the trigger to Poll Response Submitted
3. Add a Send Webhook action to the automation
4. For the webhook URL, copy the URL shown in the Oshi Beehiiv modal. It looks like https://app.oshi.tech/api/webhooks/newsletter/your-business-id
5. Add one header to the webhook request:
   • Key: Authorization
   • Value: Bearer followed by your Oshi API key (use the copy button in the Oshi modal to grab the full key)
6. Publish the automation

Step 5: Test the Connection

With the automation published, trigger a poll response in Beehiiv — answering a poll in a test send is enough.

While you wait, the Oshi modal shows Waiting for test webhook from Beehiiv. As soon as the first webhook arrives, it updates to Automation connected successfully and stores the automation for you. This usually takes a few seconds.

Until this confirmation appears, no rewards will be issued.

Step 6: Turn On Newsletter Rewards

Connecting Beehiiv does not start paying rewards by itself. You still need to set an amount and activate the program. See How to set up newsletter rewards for the next step.

Linking Subscribers to Their Rewards

Once rewards are flowing, subscribers need a way to see their balance. Add a button or link to your newsletter template pointing at:

https://portal.bitcoinrewards.app/n/{{subscription_uuid}}

Beehiiv fills in the {{subscription_uuid}} merge tag for each recipient, and the link signs that subscriber straight into their rewards portal — no password, no account creation. It's the single most effective way to make the rewards feel real to your list.

Ready-to-Paste Rewards Card

Drop this into a Beehiiv email as a custom HTML block. It renders as a bordered card with a call-to-action button, and it works in every major email client.

<table width="100%" cellpadding="0" cellspacing="0" border="0" style="border: 1px solid #E1E1E1; border-radius: 12px; font-family: Helvetica, Arial, sans-serif;">
  <tbody><tr>
    <td style="padding: 20px 24px; text-align: center;">

      <p style="margin: 0 0 14px 0; color: #555555; font-size: 14px; line-height: 1.5;">
        Check your balance. Discover new places to earn.
      </p>

      <a href="https://portal.bitcoinrewards.app/n/{{subscription_uuid}}" style="display: inline-block; background-color: #030712; color: #ffffff; text-decoration: none; font-size: 14px; font-weight: 600; padding: 10px 24px; border-radius: 8px;">
        View My Rewards →
      </a>

    </td>
  </tr>
</tbody></table>

Change the wording, colours, and button label to match your publication. The only part that has to stay exactly as written is the href — the portal URL with the {{subscription_uuid}} merge tag.

Troubleshooting

The Beehiiv card doesn't appear on my Connections page. Newsletter Rewards is enabled per account. Contact Oshi support to have it switched on.

The modal never confirms the automation. Check that the automation is published in Beehiiv, not saved as a draft. Then confirm the webhook URL has no trailing spaces and the Authorization header value starts with Bearer including the space.

The connection is confirmed but nobody is earning. The most common cause is the poll's age. By default Oshi only rewards responses to polls created in the last 24 hours. See How to configure newsletter poll rules to widen or remove that window.

Rewards stopped suddenly. Check your rewards balance. If your account runs out of sats mid-program, newsletter rewards stop being paid out. See How to fund your rewards balance.

What's Next

• Set up newsletter rewards — Choose a flat amount or scale rewards up for your most engaged readers.
• Configure newsletter poll rules — Control which polls pay out and for how long.
• Understand newsletter reward unlocks — Learn how subscribers unlock and withdraw what they earn.