# Webhooks

Digital Samba Embedded currently support ed events: ‘session started’, ‘session ended’, ‘participant joined’, ‘participant left’, ‘recording started’, ‘recording stopped’, ‘recording ready for download’

To **create a new webhook**, go to the [Webhooks section](https://dashboard.digitalsamba.com/webhooks) of the dashboard and clic on the 'Add webhook'. This is also where you'll be able to **get the list of your team's created webhooks**.

<figure><img src="https://1546941876-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiO3v6IGLbE8FriBtsLy2%2Fuploads%2FO4qLTG1oJFR1TD1TPi1q%2Fimage.png?alt=media&#x26;token=f9ce0c36-3105-4692-aec6-a2c9f5aab0af" alt=""><figcaption></figcaption></figure>

When creating or editing a webhook:&#x20;

* You'll need to add the **URL** to the endpoint that the webhook should send its data to process it as needed. This is a required field.&#x20;
* You may also optionally add a **description** to help other team members understand your purpose or even to keep it clear for yourself, over time.
* The **authorisation header** field is also not required, but highly recommended if you want to authenticate the request and ensure that it is coming from a trusted source. The token or credentials should be generated by the server that is receiving the webhook, and should be kept secure.&#x20;
* Finally you'll need to select the **event** or **events** that should trigger the webhook on Digital Samba Embedded's side. Digital Samba supports the following events: 'session started', 'session ended', 'participant joined', 'participant left', 'recording started', 'recording stopped', and 'recording ready for download'.&#x20;
* In addition Digital Samba supports the following Library Events
  * Folder added to library
  * Folder renamed
  * Folder deleted from library
  * File added to library
  * File processing failed
  * File renamed
  * File deleted from library

{% hint style="info" %}
You may also use the [REST API](https://docs.digitalsamba.com/rest-api) to get the list of webhooks, get a specific one, create a new one, update or delete it.
{% endhint %}