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:
- Log in to Partnero.
- Choose the program you'd like to work with.
- Go to Integration under Program, then scroll to find the Webhooks section:
- Click Create webhook on the right.
- Enter the webhook name and endpoint URL. Then, select the events you'd like to send:
- Click Create.
You can find more information about webhooks as well as code examples in our Developers documentation.