Updated: Dec 10, 2024
Using webhooks with your beehiiv account
Available on paid beehiiv plans. Click here to upgrade your account.
Working with webhooks
Webhooks are automated messages that trigger actions between applications, enabling seamless integration between beehiiv and virtually any platform. They open up endless possibilities for customizing and enhancing your workflows.
In beehiiv, you can also incorporate webhooks into automation workflows. For example, you can send subscriber data to another platform as part of your automation process.
This article will guide you through:
- The webhook events available on beehiiv.
- A video example of setting up webhooks.
- Step-by-step written instructions for creating a webhook using Make.com, beehiiv, and Slack.
Tech Note: While our support team is happy to help with beehiiv's functionality, we are unable to assist with third-party tools or services. For beehiiv-related assistance, visit the Help page in the top navigation bar. You'll find resources there, including our chatbot Buzz, for quick support.
Webhook events in beehiiv
We provide webhooks for the following events on the beehiiv platform:
- Post Sent: Triggered whenever a post is published as an email.
- Subscription Created: Triggered when a new subscriber signs up.
- Subscription Confirmed: Triggered when a new subscriber opts in and moves to Active status.
- Subscription Deleted: Triggered when a subscriber unsubscribes.
- Subscription Upgraded: Triggered when a subscriber upgrades their account.
- Subscription Downgraded: Triggered when a new subscriber downgrades their account.
Watch and learn: How to create a webhooks
Important Note: All webhooks require an endpoint URL to function. In our example, we use Make.com to generate the endpoint URL. If you’re using a different provider, the steps may vary. The instructions in this video and article will guide you through setting up a webhook between beehiiv and Slack, where a new beehiiv post triggers a virtual notification in Slack. To follow along, you’ll first need to create an account with Make.
Disclaimer: The beehiiv platform has evolved since the filming of these videos, so parts of the user interface featured in the videos will be slightly different that what you see in your account. Specifically, webhooks has moved to Settings > Webhooks.
Part 1: Create the webhook
- Log into your Make account. Navigate to Scenarios and then click Create a New Scenario in the top right corner.
- You will first need to create the trigger for the webhook. For this example, the trigger will occur when a new beehiiv post is live. Click the + icon and select beehiiv as the trigger location.
- You’ll be prompted to ‘Choose a hook’ or add a new one. You’ll be presented with a list of hook options to choose from. Select Watch for Subscribers, which triggers when a new subscriber is added.
- Once you’ve selected the webhook, give it a name that is easy to identify. We've used ‘New subscribers’ for this example. Click Save to save your webhook name.
- After saving, a URL will appear below the webhook name. Click Copy address to clipboard to copy the URL link.
- Log into your beehiiv account. From the left panel dashboard, go to Settings > Webhooks. Click Create Webhook Endpoint.
- Under Endpoint URL, paste the URL that you copied from Make in step 5. Then, add a description of your webhook endpoint to help you identify it later.
-
Select the event types you want to trigger your webhook. For this example, we selected Subscription Created.
Reminder: You can find descriptions of the available event types in the 'Webhook events in beehiiv' section above. - Review the summary of your webhook configuration on the right side. If everything is set up correctly, click Create Webhook.
Once created, all of your webhooks will be displayed on the Webhooks page in your beehiiv account, where you can deactivate or edit them at any time.
Part 2: Activate the webhook
Now, we’ll set up what happens after a new subscriber triggers the webhook to create a Slack message.
- Return to your Make account and navigate to Scenarios again. Click on the + icon to add another module to your webhook. For this example, we selected Slack.
- Depending on the webhook event you are tracking, you’ll see various information options to choose from. For this example, we selected Create a Message.
- Since we are tracking new subscribers, information like email, subscription tier, and more will be available. Fill out the required details and click Save.
Part 3: Test the webhook
It’s important to test your webhook to ensure everything is set up correctly.
- In your Make account, click the Play icon to start testing your webhook.
- Go to your beehiiv website and use a test email address to subscribe as a new user.
- After a short time, return to your Make account. You should see a number ‘1’ displayed on top of each scenario, indicating one new subscriber and one Slack message sent.
- To keep the webhook automation active, toggle the On/Off switch to On, then click Save in the bottom left corner.
Congratulations! Your webhook is now active! 🎉