---
title: "Create new object"
method: POST
path: "/objects"
tags: ["Objects"]
---

# Create new object

`POST /objects`

Creates a new object with the specified parameters

## Request body

- ObjectCreationData
  - `objectType` integer, required — Object type codes: - 1: SUBNET - 2: NODE - 3: INTERFACE - 4: NETWORK - 5: CONTAINER - 6: ZONE - 7: SERVICEROOT - 8: TEMPLATE - 9: TEMPLATEGROUP - 10: TEMPLATEROOT - 11: NETWORKSERVICE - 12: VPNCONNECTOR - 13: CONDITION - 14: CLUSTER - 15: BUSINESSSERVICEPROTOTYPE - 16: ASSET - 17: ASSETGROUP - 18: ASSETROOT - 19: NETWORKMAPROOT - 20: NETWORKMAPGROUP - 21: NETWORKMAP - 22: DASHBOARDROOT - 23: DASHBOARD - 24: DASHBOARDTEMPLATE - 27: BUSINESSSERVICEROOT - 28: BUSINESSSERVICE - 29: COLLECTOR - 30: CIRCUIT - 31: MOBILEDEVICE - 32: RACK - 33: ACCESSPOINT - 34: WIRELESSDOMAIN - 35: CHASSIS - 36: DASHBOARDGROUP - 37: SENSOR - 10000: CUSTOM
  - `name` string, required — Object name
  - `parentId` integer, required — Parent object ID this object to be created under
  - `comments` string — Object comment
  - `creationFlags` integer — Bit flags for object creation: - 0x0001: DISABLE_ICMP - 0x0002: DISABLE_NXCP - 0x0004: DISABLE_SNMP - 0x0008: CREATE_UNMANAGED - 0x0010: ENTER_MAINTENANCE - 0x0020: AS_ZONE_PROXY - 0x0040: DISABLE_ETHERNET_IP - 0x0080: SNMP_SETTINGS_LOCKED - 0x0100: EXTERNAL_GATEWAY - 0x0200: DISABLE_SSH - 0x0400: DISABLE_MODBUS_TCP - 0x0800: DISABLE_VNC
  - `primaryName` string — Node primary name (IP address or DNS name)
  - `agentPort` integer — Node agent port
  - `snmpPort` integer — Node SNMP port
  - `etherNetIpPort` integer — Node EtherNet/IP port
  - `sshPort` integer — Node SSH port
  - `ipAddress` string — Interface IP address
  - `agentProxyId` integer — Node agent proxy ID
  - `snmpProxyId` integer — Node SNMP proxy ID
  - `etherNetIpProxyId` integer — Node EtherNet/IP proxy ID
  - `icmpProxyId` integer — Node ICMP proxy ID
  - `sshProxyId` integer — Node SSH proxy ID
  - `mapType` integer — Network map type
  - `seedObjectIds` integer[] — Network map seed objects
  - `zoneUIN` integer — Subnet/Node/Zone zone UIN
  - `serviceType` integer — Network service type: - 0: CUSTOM - 1: SSH - 2: POP3 - 3: SMTP - 4: FTP - 5: HTTP - 6: HTTPS - 7: TELNET
  - `ipPort` integer — Network Service IP port
  - `request` string — Network Service request string
  - `response` string — Network Service expected response
  - `linkedNodeId` integer — Linked node ID for NodeLink object
  - `template` boolean — If service check object is a template
  - `macAddress` string — Interface or sensor MAC address
  - `ifIndex` integer — Interface index
  - `ifType` integer — Interface type
  - `module` integer — Interface module number
  - `port` integer — Interface port number
  - `physicalPort` boolean — Whether interface has a physical port
  - `createStatusDci` boolean — Whether a status DCI should be created for network service
  - `deviceId` string — Mobile device ID
  - `height` integer — Rack height
  - `controllerId` integer — Chassis controller node ID
  - `sshLogin` string — Node SSH login
  - `sshPassword` string — Node SSH password
  - `deviceClass` integer — Sensor device class
  - `vendor` string — Sensor vendor
  - `commProtocol` integer — Sensor communication protocol
  - `xmlConfig` string — Sensor XML configuration
  - `xmlRegConfig` string — Sensor XML registration configuration
  - `serialNumber` string — Sensor serial number
  - `deviceAddress` string — Sensor device address
  - `metaType` string — Sensor meta type
  - `description` string — Sensor description
  - `sensorProxy` integer — Sensor proxy node ID
  - `instanceDiscoveryMethod` integer — Business service instance discovery method: - 1: IDM_AGENT_LIST - 2: IDM_AGENT_TABLE - 5: IDM_SCRIPT

## Response `200`

Object created successfully

- object
  - `id` integer — ID of the created object

## Other responses

- `400` — Invalid request
- `401` — Access denied

---

[API](https://skmtc.net/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/versions/5743b9619c90/schema)