---
title: Getting Started
slug: getting-started
icon: {"lucideIcon":"Webhook"}
createdAt: 2025-08-20T18:51:21.485Z
---

## Create a Webhook Subscription

To get your offering setup with webhooks on EquiDeFi, start by going to the Offering Settings

![](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/a73JVPLHzUqu43M4GzYcH_image.png)

There will be a "Webhooks" navigation tab on the left side of the page.

:::::VerticalSplit{layout="middle"}
:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/BMYNCGcPkwu4dCWEgE5fj_image.png)
:::

::::VerticalSplitItem


:::hint{type="warning"}
If you do not see this tab, this means either:

1. You are not an **Owner** on the offering.
2. Your EquiDeFi offering has not has webhooks enabled by our support team. Reach out to support if you need help enabling webhooks
:::
::::
:::::

At this point you can click "Add Webhook" and you will get a dialog box to create your first webhook subscription

![Webhook Subscription Dialog](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/v4JOWy773-BdHTHNjp0-M_image.png)

There are some important things to consider when creating your webhook.

1. You must use a **publicly-facing URL.&#x20;**`localhost` or `127.0.0.1` will not work. If you are testing locally, you can use a tool like [`ngrok`](https://ngrok.com/) to tunnel your local server to a public URL or use a more robust service like [Hookdeck](https://hookdeck.com).&#x20;
2. If the URL cannot be resolved or is invalid, you will not be able to use it.
3. You can subscribe to **All events** (default), or specify individual events.

Once you click "Add Webhook" in the dialog, your webhook events should start firing immediately

## Webhook Signing Secret

After your subscription is created, you will be shown your **Signing Secret**. You will be able to use this value to verify incoming webhook requests securely on your servers. See the [Verifications](https://docs.equidefi.io/best-practices#payload-verification) area for more information

:::hint{type="info"}
You can always find your Signing Secret from the Webhook Subscription detail page if you misplace it.
:::

![](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/a0FqwWzhaRX0L7SDml33i_image.png)

## Viewing the Subscription

You can monitor and check the events that a subscription has fired from the Webhook Subscription detail page.

![](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/r7mt4Hb3JLRRgXvPAOuxv_image.png)

From here you can also view the Signing Secret, make edits to the subscription, disable or enable the subscription, or **delete** it if you do not need it anymore.

## Viewing Events

You can view the full JSON payload, the number of attempts made to send the payload, when it was delivered, the response code from your server, and you can also jump *directly* to the investment connected to that investment.

![](https://api.archbee.com/api/optimize/dOqq_NWIQgrNMp0apjZ7I/vZ77L13YQhrqZwRYPVXAI_image.png)

