---
title: "Hanwha Device"
source: /gcxone/devices/hanwha-device-configuration
locale: en
updated: 2026-09-08
---
## **Introduction**

This guide describes the steps required to configure a Hanwha device for integration with the GCXONE platform. It covers device onboarding and webhook configuration for event routing.

## **Hanwha Config Guide with GCXONE**

**Step 1:** Navigate to the **Devices** tab.

![fig](/api/media/file/17e011c0b2c10c68d5e528288170a0a2793b33b0-1920x989.png)

**Step 2:** Click the **Add New** button.

![FIG](/api/media/file/073e8f2d8132a7fbd3d8f2f50d3e72e3d1fb98b1-1914x991.png)

**Step 3:** The **Add Device** dialog will be displayed.

![Hanwha device configuration](/api/media/file/0320f853832415bef380fce5b5f1d289f0008d1f-1920x986.png)

**Step 4:** In the dialog, open the **Device** dropdown and select **HanwhaNVR**.

![1](/api/media/file/Screenshot-2026-08-16-135300-edited-27d77bf8.png?prefix=media)

**Step 5:** Enter all required fields: IP Address or Host, Serial Number, Username, Password, Control Port, RTSP Port, Server Port, HTTPS Port.

**Note:** The **HTTPS Port** field is mandatory when adding a Hanwha device.

![FIG](/api/media/file/fecc166d0e2b19f04490e779be69218217307036-1920x908.png)

**Step 6:** Below the connection fields, the dialog also has a **Name** field and **Select Entity Group** dropdown, a required **Timezone**, an **Enable Audio** toggle, a **Device Configuration** section (Site Pulse Configuration), an **Advanced Settings** section (Event Polling, Configure Heatmap Mask, Periodic Health Check, Event Retention Time — 30 days by default), and an optional **Location** section (Latitude, Longitude, Plus Code, What3Words).

**Step 7:** Click Discover.

![Hanwha device configuration](/api/media/file/1ef7cdd14afc18a393a730cb21835f0104dceb67-1920x1032-2.png)

**Step 8:** Once the device is successfully discovered, click **Save**.

![1](/api/media/file/d7ca8d0dfe1b4ea5af6eed47d51d88bad4edb4cf-1920x911-edited-60744d92.png?prefix=media)

## **Webhook Configuration for Hanwha Device**

This section describes how to verify webhook configuration for event routing in Hanwha devices.

**Step 1:** Log in to the **Hanwha device web client**.

**Step 2:** Select the required **Sensor** from the sidebar.

**Step 3:** Right-click the sensor and select **Camera Changes**.

![Hanwha device configuration](/api/media/file/9f0876a8a6026f358cfd24055d90183981c7ad6b-1818x933.png)

**Step 4:** From the event rule list, click **Do HTTPS Request**.

![Hanwha device configuration](/api/media/file/af38a432f94b54ea5ceb9cdef0b7d3399b1b77ab-1433x889.png)

**Step 5:** Verify the configured **HTTP URL** and **HTTP Content**.

![Hanwha device configuration](/api/media/file/1fb6593600ed29c3e9922b07b695ac58805027ba-1509x894.png)