How to set up webhooks

What are webhooks?

Webhooks allow you to subscribe to real-time notifications about various events that occur in Partnero. For example, when a new partner is added to your account, HTTP POST callback is sent to your provided URL with a message (called a payload) containing the new partner data. It allows you to get the most recent updates without constantly polling the API. You can see your existing webhooks, create new, update and delete them.

Available events

In order to create a webhook, you'll need to know the event you want to listen for, as well as the URL you want us to send new events to. Below is a list of events you can listen to and send a notification for:

Event Description
partner.created Fired when the new partner signups or is created manually.
partner.updated Fired when existing partner is updated.
partner.deleted Fired when a partner is deleted.
customer.created Fired when the new customer is created.
customer.updated Fired when existing customer is updated.
customer.deleted Fired when existing customer is deleted.
transaction.created Fired when new transaction happens.
transaction.deleted Fired when transaction is deleted.

Create a webhook on Partnero

To create a webhook:

  1. Log in to Partnero.
  2. Choose the program you'd like to work with.
  3. Go to Integration under Program, then scroll to find the Webhooks section:
  4. Click Create webhook on the right. 
  5.  Enter the webhook name and endpoint URL. Then, select the events you'd like to send:
  6. Click Create.
You can find more information about webhooks as well as code examples in our Developers documentation.