# Webhooks

Webhooks provide a way to receive real-time notifications about events occurring within your Digital River account. These notifications are sent via HTTP POST requests, allowing your application to respond immediately to changes, even those not initiated through direct API interactions. Setting up one or more webhook endpoints ensures your system stays updated and synchronizes seamlessly with Digital River events, facilitating efficient and engaging app experiences.

Digital River can send webhook events that notify your application whenever an event occurs in your account. This mechanism is especially useful for events that are not triggered by a direct API request and for services that are not directly responsible for making an API request but still need to know the response to that request.

Register webhook URLs, and we will notify you of any event in your account. When the event occurs, Digital River creates an Event object.

This Event object contains all the relevant information about what happened, including the event and the associated data. Digital River then sends the Event object, via an HTTP POST request, to any endpoint URLs you have defined in your account’s Webhooks settings. You can have Digital River send a single event to many webhook endpoints.

{% openapi src="/files/iNzDkkGaCIlZVrD9ZEeL" path="/webhooks" method="get" %}
[2021-12-13.json](https://567528635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx8fSFzVR3sg0TsNWwwVz%2Fuploads%2FSUFVdYf4YqsQ129w6x7r%2F2021-12-13.json?alt=media\&token=bc5327cc-9dda-4f0f-bdb6-2f7c8457459e)
{% endopenapi %}

{% openapi src="/files/iNzDkkGaCIlZVrD9ZEeL" path="/webhooks" method="post" %}
[2021-12-13.json](https://567528635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx8fSFzVR3sg0TsNWwwVz%2Fuploads%2FSUFVdYf4YqsQ129w6x7r%2F2021-12-13.json?alt=media\&token=bc5327cc-9dda-4f0f-bdb6-2f7c8457459e)
{% endopenapi %}

{% openapi src="/files/iNzDkkGaCIlZVrD9ZEeL" path="/webhooks/{id}" method="get" %}
[2021-12-13.json](https://567528635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx8fSFzVR3sg0TsNWwwVz%2Fuploads%2FSUFVdYf4YqsQ129w6x7r%2F2021-12-13.json?alt=media\&token=bc5327cc-9dda-4f0f-bdb6-2f7c8457459e)
{% endopenapi %}

{% openapi src="/files/iNzDkkGaCIlZVrD9ZEeL" path="/webhooks/{id}" method="delete" %}
[2021-12-13.json](https://567528635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx8fSFzVR3sg0TsNWwwVz%2Fuploads%2FSUFVdYf4YqsQ129w6x7r%2F2021-12-13.json?alt=media\&token=bc5327cc-9dda-4f0f-bdb6-2f7c8457459e)
{% endopenapi %}

{% openapi src="/files/iNzDkkGaCIlZVrD9ZEeL" path="/webhooks/{id}" method="patch" %}
[2021-12-13.json](https://567528635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx8fSFzVR3sg0TsNWwwVz%2Fuploads%2FSUFVdYf4YqsQ129w6x7r%2F2021-12-13.json?alt=media\&token=bc5327cc-9dda-4f0f-bdb6-2f7c8457459e)
{% endopenapi %}


---

# 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.digitalriver.com/digital-river-api-reference/2021-12-13/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.