How to use beehiiv Webhooks

Available on Scale and Enterprise plans. Click here to upgrade your account.

Working with webhooks

Webhooks act as virtual notifications between applications that are triggered by an event, like when you get an email that a package you ordered has been shipped out, or if you want to get a notification each time you get a new subscriber. Working in realtime, webhooks allow for data to be received from one application to another and can help to refine the actions that your subscribers take.

Webhook events in beehiiv

We provide webhooks for the following events on the beehiiv platform:

  • Post sent: Triggers any time a post is published as an email
  • Subscription created: Triggers when a new subscriber has just signed up
  • Subscription confirmed: Triggers when a new subscriber has opted in and has been moved to active 
  • Subscription deleted: Triggers when a subscriber has unsubscribed 
  • Subscription upgraded: Triggers when a subscriber has selected to upgrade their account
  • Subscription downgraded: Triggers when a new subscriber has selected to downgrade their account

How to create a webhooks automation

All webhooks require an endpoint URL and in this example, we will be using Make to generate an endpoint URL, so these steps may differ for you depending on your provider. In the following instructions, we will be creating a webhook between beehiiv and Slack where the trigger is a new beehiiv post and the virtual notification is a Slack message. 

Part 1: Create the webhook 

1. Log into your Make account and go to Scenarios, then and in the top right, click on Create a New Scenario.

Webhooks_01.png

 

2. You will first need to create the trigger for the webhook, which in this case, will be when a new beehiiv post is live. Click on + and select beehiiv as the trigger location. 

Webhooks_02.png

 

3. Next, you’ll be prompted to “Choose a hook” or add a new one. There are lots of hook options to choose from. For this example, we are selecting Watch for Subscribers which will trigger when a new subscriber has been added.

Webhooks_03.png

 

4. Once a new webhook has been selected, you’ll need to give it a name that should be easy to identify, we’ve used New subscribers for this example. Click on the Save button. 

Webhooks_04.png

 

5. You’ll see that a URL has appeared below your webhook name. Click on Copy address to clipboard to copy the link.

Webhooks_05.png

 

6. Log into your beehiiv account and from the left panel options, go to Settings > Integrations  > then click on the Webhooks tab found up top. Click on the Get Started button. 

Webhooks_06.png

7. Here’s where you will paste the Endpoint URL (that was copied from Make in the example) and add a Description of the webhook, we used “New subscribers”.

Webhooks_07.png

8. Now you’ll need to select the webhook event that you’d like to use. You can choose between subscription created, confirmed, deleted, upgraded, or downgraded, and post sent. We used “subscription created” for this example. Once selected, click on Next

Webhooks_08.png

 

9. You’ll be asked to review all of the details in beehiiv and then click on Save.

Webhooks_08a.png

Once added, all of your webhooks will be displayed on this tab in your beehiiv account where you can inactive or edit them at any time.

 

Webhooks_08b.png

 

Part 2: Connect the webhook

Now we need to set up what happens after you get a new subscriber and connect the webhook to create a Slack message once the trigger has happened.

10. Go back to your Make account and navigate to Scenarios again. Click on the + icon to add another module to your webhook, select Slack.

Webhooks_09.png

 

11. Depending on which webhook event you are tracking, you will see different information available to choose from. For this example, we used Create a Message

Webhooks_10.png

 

12. Since we are tracking New Subscribers, we can see information regarding the email, subscription tier, and more. Fill out the needed information and click on Save

Webhooks_11.png

 

Part 3: Test & activate the webhook

13. To be sure everything is set up correctly, it’s best to test your webhook. You can do this by clicking on the Play icon found in the bottom left corner of your Make account. 

Webhooks_12.png

14. Next, you’ll need to go to your website and when prompted to become a new subscriber, enter in a test email address. 

Webhooks_13.png

15. After a bit of time, head back to your Make account and you’ll see a number “1” on top of each scenario signifying that one person has just subscribed, and one message has just been sent on Slack. 

Webhooks_14.png

16. To make the webhook automation active, be sure to click on the On/Off toggle and turn it on, then click on Save in the bottom left corner.

Congrats the webhook is now active! 🎉

 

Was this article helpful?