# Webhooks

## Overview

Webhooks allow Welkin to send real-time HTTP notifications to external systems when specific events occur in your environment. Common use cases include syncing data to an EHR, triggering workflows in external platforms, or alerting data pipelines when patient records are updated.

***

## How Webhooks Work

1. An event occurs in Welkin (e.g., patient created, assessment completed, CDT record updated).
2. Welkin sends an HTTP POST request to your configured webhook endpoint.
3. The endpoint receives the payload and processes it.

The payload contains event details including the event type, timestamp, and relevant record data in JSON format.

***

## Configuring Webhooks in the Designer

See [How to Create Webhooks](/designer/webhooks/how-to-create-webhooks.md) for step-by-step setup.

***

## Managing Webhooks in the Admin Portal

Active webhooks can be viewed and managed in **Admin Portal → Integrations → Webhooks**. See [Webhooks (Admin)](https://welkin-health-1.gitbook.io/welkin-health-docs/admin).

***

## Webhook Security

Welkin supports webhook signature verification to ensure payloads are authentic:

* Each webhook payload includes a signature header
* Your endpoint can verify the signature using your shared secret
* This prevents spoofed requests from malicious sources

Configure the webhook signature secret in the webhook setup. See [Mobile App Signature and Webhook Event Signature settings](https://welkin-health-1.gitbook.io/welkin-health-docs/admin).

***

## Retry Behavior

If your endpoint returns a non-2xx response, Welkin will retry the webhook delivery. Ensure your endpoint is idempotent (i.e., processing the same event twice produces the same result).

***

## Publishing

After creating or modifying webhooks in the Designer, create a draft and publish. The webhook is then visible in the Admin Portal for activation.

***

## Related Topics

* [How to Create Webhooks](/designer/webhooks/how-to-create-webhooks.md) – webhook configuration guide
* [Webhooks (Admin)](https://welkin-health-1.gitbook.io/welkin-health-docs/admin) – managing webhooks in Admin
* [Integrations Overview](https://welkin-health-1.gitbook.io/welkin-health-docs/integrations) – integration setup
* [API Clients](https://welkin-health-1.gitbook.io/welkin-health-docs/admin#api-clients) – API authentication


---

# 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.welkinhealth.com/designer/webhooks/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.