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.

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.