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

# Create object

`POST /objects`

Request to create new object

## Request body

- ObjectCreation
  - `objectType` integer — Possible options: * SUBNET: 1 * NODE: 2 * INTERFACE: 3 * NETWORK: 4 * CONTAINER: 5 * ZONE: 6 * SERVICEROOT: 7 * TEMPLATE: 8 * TEMPLATEGROUP: 9 * TEMPLATEROOT: 10 * NETWORKSERVICE: 11 * VPNCONNECTOR: 12 * CONDITION: 13 * CLUSTER: 14 * OBJECT_BUSINESSSERVICE_PROTOTYPE: 15 * NETWORKMAPROOT: 19 * NETWORKMAPGROUP: 20 * NETWORKMAP: 21 * DASHBOARDROOT: 22 * DASHBOARD: 23 * BUSINESSSERVICEROOT: 27 * BUSINESSSERVICE: 28 * NODELINK: 29 * SLMCHECK: 30 * MOBILEDEVICE: 31 * RACK: 32 * ACCESSPOINT: 33 * CHASSIS: 35 * DASHBOARDGROUP: 36 * SENSOR: 37
  - `name` string — Object name
  - `parentId` integer — Parent object id this object to be created under
  - `comments` string — Object comment
  - `creationFlags` integer — Bit flags for object creation. Possible options: * DISABLE ICMP: 0x0001 * DISABLE NXCP: 0x0002 * DISABLE SNMP: 0x0004 * CREATE UNMANAGED: 0x0008 * ENTER MAINTENANCE: 0x0010 * AS ZONE PROXY: 0x0020 * DISABLE ETHERNET IP: 0x0040 * SNMP SETTINGS LOCKED: 0x0080 * EXTERNAL GATEWAY: 0x0100
  - `primaryName` string — Node primary name (IP address or dns name)
  - `agentPort` integer — Node agent port
  - `snmpPort` integer — Node SNMP port
  - `etherNetIpPort` integer — Node ethernetIP 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 ethernetIP 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 types: * CUSTOM - 0 * SSH - 1 * POP3 - 2 * SMTP - 3 * FTP - 4 * HTTP - 5 * HTTPS - 6 * TELNET - 7
  - `ipPort` integer — Network Service IP port
  - `request` string — Network Service request
  - `response` string — Network Service response
  - `linkedNodeId` integer — Linked object for Node Link object
  - `template` boolean — If service check object is 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
  - `physicalPort` boolean — IF interface has physical port
  - `createStatusDci` boolean — IF 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 password
  - `deviceClass` integer — Sensor device class
  - `vendor` string — Sensor vendor
  - `commProtocol` integer — Sensor communication protocol
  - `xmlConfig` string — Sensor XML config
  - `xmlRegConfig` string — Sensor XML registration config
  - `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 Possible values: * IDM_AGENT_LIST - 1 * IDM_AGENT_TABLE - 2 * IDM_SCRIPT - 5

## Response `200`

New object ID.

- object

## Changes

- **2023-02-23** `9c09a2aad349` — 1 warning, 16 info
  - removed the optional property `id` from the response with the `200` status
  - api operation id `createObject` removed and replaced with ``
  - the request property `name` became optional
  - the request property `objectType` became optional
  - …13 more

[Change history](https://skmtc.dev/netxms/apis/netxms-rest-api/changes/objects/post.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/revisions/9c09a2aad349/schema)