Webhook
Damon Chen avatar
Written by Damon Chen
Updated over a week ago

🚀 You have to subscribe to Premium plan or above to use Webhook

Introduction

Webhook allows you to send real-time notifications of events within testimonial.to to external services.

You can create/manage the webhook on your Settings page. Scroll down and you will find the Webhook section 👇

notion image

A webhook consists of:

  • A URL you have configured, to which a webhook event will be posted

  • One or more events, which will be posted to a specified URL

  • A secret key, which can be used to verify a webhook payload was sent by testimonial.to

When a webhook is triggered, a POST request will be made to the URL configured along with a JSON payload specific for the event type.

All events

You can configure a webhook to be sent on the following events:

  • create - when a testimonial is created

  • like - when a testimonial is liked

  • unlike - when a testimonial is unliked

  • delete - when a testimonial is deleted

Sample payload

create event

Generated when a video/text testimonial is created

like event

Generated when a video/text testimonial is liked

unlike event

Generated when a video/text testimonial is unliked

delete event

Generated when a video/text testimonial is deleted

Verifying webhook signature

Each webhook event is signed via a Hash-based Message Authentication Code (HMAC) using the webhook’s secret key.

The HMAC-SHA1 algorithm is used to generate the webhook payload signature. Each request's signature is passed along in the headers as ‘X-Testimonial-Signature.’

notion image

Node.js verify example


If you need help or have any questions, just click on the live chat widget. We will reach back as soon as possible ✌️

Did this answer your question?