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, an 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
To create a webhook, you'll need to specify the event you want to listen for and 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 a new partner signs up or is created manually. |
| partner.updated | Fired when an existing partner is updated. |
| partner.deleted | Fired when a partner is deleted. |
| partner.approved | Fired when a partner is approved. |
| partner.rejected | Fired when a partner is rejected. |
| partner.archived | Fired when a partner is archived. |
| customer.created | Fired when the new customer is created. |
| customer.updated | Fired when an existing customer is updated. |
| customer.deleted | Fired when an existing customer is deleted. |
| transaction.created | Fired when a new transaction happens. |
| transaction.deleted | Fired when a transaction is deleted.
|
| lead.submitted
|
Fired when a new lead is submitted. |
| lead.converted | Fired when a lead is converted. |
| lead.rejected | Fired when a lead is rejected. |
Create a webhook on Partnero
To create a webhook:
- In your affiliate program, go to Integration and switch to the Webhooks tab:
- Click Create webhook.
- 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 Developer documentation.