You can use webhooks to integrate Promoter with external systems. Since the hooks are event driven and push-based, you don't need to poll Promoter, asking "Has anything happened?" As soon as something happens, we'll let you know. You can configure and test webhooks using the Webhooks settings page in your account.
Supported Webhooks
General Promoter Accounts
Webhooks and their response bodies
feedback.added_or_changed
- Feedback was created or changed.feedback.tags_added_or_changed
- Feedback had a Tag added/updated/removedfeedback.status_changed
- Status of a feedback changedfeedback.removed
- Feedback was removedmetric.score_changed
- NPS score changed for a given campaigncontact.unsubscribed
- Contact unsubscribedtag.merged
- Tag was merged in a campaign via Tag Managementtag.removed
- Tag was deleted from a campaign via Tag Managementtag.renamed
- Tag was renamed from a campaign via Tag Management
eCommerce Promoter Accounts
Webhooks and their response bodies
survey.response_added_or_changed
- a new response has come in or has been updatedsurvey.response_removed
- response was removed/deletedcontact.unsubscribed
- contact unsubscribed
Setting Up a Webhook
Navigate to the Intergrations section in Promoter.
Click 'Configure' under Webhooks.
Click + Create Webhook at the top of the page.
Choose the event you want to listen for (for example, feedback is added).
Add your webhook URL under Target URL.
Choose the campaign to connect the webhook to.
Click Create.