Skip to main content

Webhook

Written by Damon Chen
Updated over 2 weeks ago

๐Ÿš€ Webhooks are available on the Ultimate plan or higher.

Introduction

Webhooks let you send real-time event notifications from Testimonial to your external apps or services.

This is useful for automating workflows, syncing data, or triggering actions whenever something happens in your account.


How to Set Up a Webhook

  • Go to the Automation section of your space.

  • Click on the Webhook option.

Here, you can create and manage your webhooks ๐Ÿ‘‡

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?