> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhino.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscribe to webhooks

> You can either setup your webhook URL once for your project in the Rhino Console or pass it on invidual bridges.

## Using the [Rhino.fi](http://Rhino.fi) Console

Go to Rhino.fi Console and select your project.

Under the Webhooks section you can define your webhook URL.

<Warning>
  Please make sure NOT to include the endpoint name `/rhinofi-event`.

  You provide: [https://my-server.com/prefix](https://my-server.com/prefix)

  Rhino.fi calls: [https://my-server.com/prefix/rhinofi-event](https://my-server.com/prefix/rhinofi-event)
</Warning>

Once defined you'll get webhook events for all the bridges associated with this project. You don't need to pass the webhookUrl parameter every time you get a quote as described in the next section.

## Bridge API

To subscribe to webhooks when using Rhino.fi bridge API, you can pass a `webhookUrl` parameter when getting a bridge quote.

You'll then start receiving webhook events on all your bridge status changes ([full list of bridge events](/webhook/events-list#bridge-events)).

Example:

```text theme={null}
webhookUrl: "https://my-server.com/prefix"
```

<Warning>
  Please make sure NOT to include the endpoint name `/rhinofi-event`.

  You provide: [https://my-server.com/prefix](https://my-server.com/prefix)

  Rhino.fi calls: [https://my-server.com/prefix/rhinofi-event](https://my-server.com/prefix/rhinofi-event)
</Warning>

For the exact specification, [see the API Reference](https://docs.rhino.fi/api-reference/quote/user-quote-for-bridge-&-swap#body-webhook-url)

## Smart Deposit Addresses API

To subscribe to webhooks when using Rhino.fi Smart Deposit Addresses API, you can pass a `webhookUrl` parameter when create a deposit address.

You'll then start receiving webhook events on all operations done on this deposit address ([full list of bridge events](/webhook/events-list#smart-deposit-addresses-events)).

Example:

```text theme={null}
webhookUrl: "https://my-server.com/prefix"
```

<Warning>
  Please make sure NOT to include the endpoint name `/rhinofi-event`.

  You provide: [https://my-server.com/prefix](https://my-server.com/prefix)

  Rhino.fi calls: [https://my-server.com/prefix/rhinofi-event](https://my-server.com/prefix/rhinofi-event)
</Warning>

For the exact specification, [see the API Reference](https://docs.rhino.fi/api-reference/depositaddresses/create-new-deposit-address#body-webhook-url)