---
url: >-
  https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/webhook-management.md
description: >-
  Webhooks allow real-time notifications and seamless data synchronization
  between your application and external services. Configure endpoints to receive
  instant updates about contacts, statuses, and other critical events in your
  system.
---

# Webhook Management - Webhook Integrations

Webhooks let your app **instantly receive updates** when something important happens — no need to keep checking manually.

**This allows your app to:**

* Sync data in real-time
* React immediately to changes
* Stay up-to-date without extra effort

For example, when a contact is updated in WhatsMark, your system gets notified instantly and can take action — like updating your CRM or triggering a workflow.

#### Key Benefits

* **Real-time updates** without polling
* **Faster automation** and integrations
* **Smarter workflows** with minimal delay

> Just set your webhook URL, choose what events you care about, and let WhatsMark handle the rest.

***

![webhook-management](../images/tenant-system-settings/webhook-management.png)

## Enable Webhook Access

At the top of the Webhook settings panel, you'll see a **toggle switch** that controls whether webhooks are active for your account.

* **Enabled (switch ON)**: WhatsMark will start sending real-time event data to your configured webhook URL(s) based on the events you've selected.
* **Disabled (switch OFF)**: No webhook data will be sent, even if you’ve entered a URL or selected events.

## Webhook URL

Enter the **URL endpoint** where you want WhatsMark to send real-time notifications.

This is the **web address** on your server (or app) that will receive event data (like new contacts, status updates, etc.) via HTTP `POST` requests.

Without a webhook URL:

* WhatsMark can’t deliver event data.
* Your app won’t receive any real-time updates.

#### Example

<https://your-domain.com/webhook>

#### Requirements

* Must be **publicly accessible**
* Should accept **POST requests** with **JSON payloads**
* Add security (e.g., secret keys or headers) to verify incoming requests

## Webhook Abilities

Choose the specific events that should trigger webhook notifications. This allows you to control exactly what kind of data your system receives from WhatsMark in real time.

The events are grouped into three categories: **Contacts**, **Statuses**, and **Sources**.

| Event Type          | Trigger Condition                    | Description                                                               |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
| **Contacts Create** | When a new contact is added          | Sends data when a new contact is created in WhatsMark.                    |
| **Contacts Update** | When an existing contact is modified | Notifies you when contact info (like name, number, tags) is updated.      |
| **Contacts Delete** | When a contact is removed            | Alerts you when a contact is deleted from the system.                     |
| **Status Create**   | When a new status is created         | Triggers when a new status (e.g., lead status) is added.                  |
| **Status Update**   | When an existing status is changed   | Sends updates when status names or settings are modified.                 |
| **Status Delete**   | When a status is deleted             | Notifies when a status entry is removed from your account.                |
| **Source Create**   | When a new source is added           | Triggers when a new source (e.g., campaign source or channel) is created. |
| **Source Update**   | When a source is edited              | Sends data when the source details (like name or type) are changed.       |
| **Source Delete**   | When a source is deleted             | Alerts you when a source is removed from your system.                     |

> **Tip:** You can enable any combination of these events based on your integration needs.

## Saving Changes

After configuring the webhook URL and selecting the desired webhook abilities, click the **Save Changes** button to apply your settings.

***

## WhatsApp Webhook Forwarding

Looking to forward **WhatsApp events** (messages, delivery statuses, template updates) to external platforms? Check out our dedicated guides:

::: tip Related Documentation
**[WhatsApp Webhook Forwarding Guide](../integrations/whatsapp-webhook-forwarding.md)** - Learn how to forward WhatsApp Business API events to N8N, Zapier, Make.com, or custom endpoints for automation workflows.

**[WhatsApp Webhook Format Reference](../integrations/whatsapp-webhook-format-reference.md)** - Technical reference for developers with payload schemas, event types, and code examples.

**[N8N Webhook Integration](../integrations/n8n-webhook-integration.md)** - Setup guide for tenant events (contacts, sources, statuses) with N8N automation.
:::

***

### Notes

* Make sure your webhook URL is publicly accessible and able to accept POST requests.
* You can customize webhook permissions to restrict or allow specific event notifications.
* Webhooks provide instant and automated data synchronization to enhance your integration workflows.
