Using webhooks with your beehiiv account

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:

1. The webhook events available on beehiiv.
2. A video example of setting up webhooks.
3. Step-by-step written instructions for creating a webhook using Make.com, beehiiv, and Slack.

We provide webhooks for the following events on the beehiiv platform, grouped below by the resource they relate to.

These events are available to publications using Newsletter lists, available to users on Max and Enterprise plans.

• Newsletter List Subscription Subscribed: Triggered when a subscriber joins a specific newsletter list, whether through a subscribe form, an automation, a manual add, or by opting in from their preference center.
• Newsletter List Subscription Unsubscribed: Triggered when a subscriber leaves a specific newsletter list, whether through a list-specific one-click unsubscribe or from their preference center.
• Newsletter List Subscription Paused: Triggered when a subscriber's membership on a newsletter list is paused. This happens automatically when the subscriber pauses their paid subscription.
• Newsletter List Subscription Resumed: Triggered when a subscriber's paused newsletter list membership resumes.

• Post Sent: Triggered whenever a post is published as an email.
• Post Updated: Triggered when an existing post is edited, for example its title, subject line, or content tags.
• Post Scheduled: Triggered when a post is scheduled to send or publish at a future date and time, rather than immediately.

• 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.
• Subscription Paused: Triggered when a subscriber pauses their subscription, for example through the Subscriber Retention Flow. Emails stop temporarily without the subscriber unsubscribing.
• Subscription Resumed: Triggered when a paused subscription resumes, either automatically when the pause period ends or when the subscriber resumes manually.
• Subscription Tier Added: Triggered when any subscription, free or premium, is added to a new premium tier.
• Subscription Tier Paused: Triggered when a subscriber's premium tier subscription is paused.
• Subscription Tier Resumed: Triggered when a subscriber's paused premium tier subscription resumes.
• Subscription Tier Deleted: Triggered when a subscription is removed from a premium tier, even if they keep access via another premium tier.

• Survey Response Submitted: Triggered when a subscriber completes any survey form. 

1. Log into your Make account. Navigate to Scenarios and then click Create a New Scenario in the top right corner.
   
   
   
2. 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.
   
   
   
3. 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.
   
   
   
4. 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.
   
   
   
5. After saving, a URL will appear below the webhook name. Click Copy address to clipboard to copy the URL link.
   
   
   
6. Log into your beehiiv account and scroll down to Settings from the left panel dashboard. At the top of the Settings panel, ensure you're in the correct publication, then click Webhooks.
   
   
   
7. In the Webhooks section, click Create Webhook Endpoint.
   
   
   
8. 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.
   
   
   

9. 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.
   
10. 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.
    
    
    

Now, we’ll set up what happens after a new subscriber triggers the webhook to create a Slack message.

10. 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.
    
    
    
11. 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.
    
    
    
12. Since we are tracking new subscribers, information like email, subscription tier, and more will be available. Fill out the required details and click Save.
    
    
    

It’s important to test your webhook to ensure everything is set up correctly.

13. In your Make account, click the Play icon to start testing your webhook.
    
    
    
14. Go to your beehiiv website and use a test email address to subscribe as a new user.
    
    
    
15. 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.
    
    
    
16. 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! 🎉