---
updatedAt: 2025-05-27T21:15:52.000Z
agentTools:
  projectIndex: https://developer-docs.rivo.io/llms.txt
---

# Getting Started with Webhooks

## Overview

Get important data from Rivo as soon as it happens.

Webhooks are a powerful resource that you can use to automate your use cases. If you are not familiar with webhooks [here's a great overview](https://requestbin.com/blog/working-with-webhooks/).

Unlike the API resources, which represent static data that you can create, update and retrieve as needed, webhooks represent dynamic resources. You can configure them to automatically notify you when a customer has taken a particular action, such as earning points, spending points, or when a custom action has occurred.

***

## Creating a Webhook

To create a webhook in Rivo:

1. From the Rivo dashboard, go to **Settings → Webhooks**
2. Click **Create Webhook**
3. In the form:
   * Select an **event type** from the dropdown (e.g. `points_event/created`)
   * Enter your **endpoint URL**
   * (Optional) Add a description for internal reference
4. Click **Save**

Once created, your webhook will appear in the list of active webhooks.

> ℹ️ You can only create **one webhook per event type**. If a webhook for an event already exists, you'll need to edit or delete it before creating a new one.

***

## Managing Webhooks

After creation, your webhook will appear in a table alongside other configured webhooks. Each entry includes:

* **Event Type** (e.g. `points_event/created`)
* **Endpoint URL**
* **Status** (Enabled or Disabled)
* **Actions** (Edit | Delete)

You can edit or delete any webhook at any time. While editing, you can:

* Enable or disable the webhook
* Update the event type, URL, or description
* Copy the **secret token** used for verifying webhook signatures (recommended for security)

> 🔐 You’ll need the secret token when implementing signature verification. Be sure to store it securely.