---
title: "Creating a SOAP Device"
description: "Configure a connection to a SOAP web service"
source_url: https://ai-ops.com/docs/devices/creating-soap
---

# Creating a SOAP Device

After [creating a device](https://ai-ops.com/docs/devices/creating-getting-started.md) with the **SOAP** protocol, you'll land on its **Configuration** tab. This is where you provide the connection details Koios needs to communicate with a SOAP web service.

> [!NOTE] Built for RDM controllers
> The SOAP protocol in Koios is designed for connecting to **RDM** (Resource Data Manager) controllers. RDM devices expose a SOAP-based API for reading and writing HVAC parameters.

## Configuration Fields

### SOAP Type

The type of SOAP service you're connecting to. This determines which additional configuration fields are shown.

| Type | Description |
|------|-------------|
| **RDM (Resource Data Manager)** | RDM controller with SOAP API |

- **Required**

### Hostname

The URL of the SOAP service endpoint.

- **Required**
- Example: `http://192.168.1.100:8080/soap`

### Timeout (seconds)

How long Koios waits for the SOAP service to respond before giving up.

- **Default:** 5 seconds
- **Minimum:** 1 second
- **Maximum:** 300 seconds (5 minutes)

### RDM Username

The username for authenticating with the RDM controller. This field appears when the SOAP type is set to **RDM**.

- **Required** (when type is RDM)

### RDM Password

The password for authenticating with the RDM controller. This field appears when the SOAP type is set to **RDM**.

- **Required** (when type is RDM)

### RDM Web Authentication

Enable this option if the RDM controller requires web-based authentication in addition to the SOAP credentials.

- **Default:** Disabled (unchecked)
- This field appears when the SOAP type is set to **RDM**

## After Configuration

Once you've filled in the connection settings:

1. **Save** the configuration
2. **Test the connection** — click the `Test` button to verify Koios can reach the SOAP service
3. **Add tags** — define the RDM device and parameter for each data point (see [Creating a SOAP Tag](https://ai-ops.com/docs/tags/creating-soap.md))
4. **Enable the device** — flip the enable switch to start scanning