---
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 - 8: TEMPLATE - 9: TEMPLATEGROUP - 11: NETWORKSERVICE - 13: CONDITION - 14: CLUSTER - 21: NETWORKMAP - 23: DASHBOARD - 28: BUSINESSSERVICE - 32: RACK - 35: CHASSIS - 37: SENSOR
  - `name` string, required
  - `parentId` integer, required
  - `comments` string
  - `creationFlags` integer
  - `primaryName` string — Node primary name (IP address or DNS name)
  - `agentPort` integer
  - `snmpPort` integer
  - `sshPort` integer
  - `zoneUIN` integer
  - `linkedNodeId` integer
  - `template` boolean
  - `mapType` integer

## Response `200`

Object created successfully

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

## Other responses

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

## Changes

- **2026-01-30** `32f48ec94aec` — 3 breaking, 1 warning, 14 info
  - added the new required request property `name`
  - added the new required request property `objectType`
  - added the new required request property `parentId`
  - removed `#/components/schemas/objectCreation, #/components/schemas/objectModification` from the request body `allOf` list
  - …14 more
- **2023-02-28** `910d3ad08e09` — 2 info
  - api operation id `createObject` was added
  - added the non-success response with the status `401`
- **2023-02-23** `1026ff73d141` — 1 breaking, 48 warning
  - added `#/components/schemas/objectCreation, #/components/schemas/objectModification` to the request body `allOf` list
  - removed the request property `agentPort`
  - removed the request property `agentProxyId`
  - removed the request property `commProtocol`
  - …45 more
- **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/32f48ec94aec/schema)