# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalsamba.com/dashboard/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.