How do I set up my product’s API using the Webhook (Postback)?

If you want to automate important actions in your digital business — like granting access to a course as soon as a purchase is approved — setting up your API via Webhook can be a great solution.

In this article, we’ll explain what the Webhook is, how to set up automatic notifications based on purchase events, where to track sent posts, and how to test the integration to make sure everything is working properly.

What is Hotmart’s Webhook?

The Webhook is a tool from Hotmart that allows you to integrate your API to receive automatic notifications whenever a transaction status is updated. In other words, you configure a URL and, whenever an event occurs (like an approved purchase, a refund, or a canceled subscription), Hotmart sends a notification to that URL.

This feature is especially useful if you host your product in an external members area and want to automatically grant access to the student once the payment is confirmed.

How to set up the Webhook?

Setting up your Webhook is simple, and you can customize it based on the events that matter most to your business. Just follow the steps below:

1. Log in to your account at: https://app.hotmart.com/login. 
2. In the left-hand menu, click Tools then Show all. 
3. Select the Webhook (API and notifications) option or search for it using the search bar. 
4. Click + Register Webhook to start a new configuration. 
5. Create the new configuration. Enter the segmentation name and select the events you want. Then, choose whether to apply the configuration to all your products or a specific product, and enter the delivery URL.
   • Note: If the registered URL returns an error, Hotmart will automatically deactivate the configuration to avoid sending incorrect notifications.
6. Click Save.

You can create as many configurations as you like. You can also edit, deactivate, or delete them directly from the same screen by clicking the corresponding action button on the right.

❯ What events can I track with the Webhook?

When setting up the Webhook, you can choose from the following events:

• For purchases: purchase canceled, purchase completed, awaiting payment, purchase approved, purchase refunded, chargeback, expired purchase, refund requested, purchase overdue.
• For subscriptions: subscription cancelation, plan change, subscription renewal date update.
• For Club: first access, module completed.
• Other: cart abandonment.

Tip: You can use these events to create important segmentations for your business. For example, a segmentation for recovering sales by selecting refund requests, chargebacks, overdue subscriptions, etc.

For more information on using Webhooks and APIs to optimize your business processes, visit this page.

How do I track the history of sent notifications?

In the Webhook menu, you’ll find the History tab, where you can track all sent posts, their status, and even the content of the notifications.

Posts with errors are automatically retried up to five times or until a successful response is received from the server. To resend a post manually, click the arrow icon in the Actions column.

You can also view the Payload (notification content) and Response History, which shows the return received from your system for that specific event. To view it, click the view details icon in the Actions column.

Important: If you were already using the Webhook (Postback) before the update, you’ll still be able to view posts sent before the tool was updated. To do this, click the Sent posts or Pending posts tabs.
Events are stored and listed in the history for up to 60 days.

Frequently asked questions

❯ Can I test if the Webhook is working?

Yes! Hotmart lets you run test posts to check if your integration is working correctly.

To do this, go to the Webhook screen, open the My settings tab, and click the list icon to the right of the configuration you want to test. Next, you can run a test post to confirm that the configured URL is receiving notifications properly.