Create Device
netbox_create_deviceAdd a new device to NetBox by providing device type, role, and site. Optionally set tags, serial, status, and other attributes.
Instructions
Create a new device in NetBox.
This adds a new row to NetBox. Ask before calling if the user wanted a dry-run.
Returns: Markdown summary of the newly created object (default) or JSON with the full NetBox response.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| face | No | Rack face. | |
| name | No | Device name (may be null for some device types). | |
| rack | No | ||
| role | Yes | Device role id (required). | |
| site | Yes | Site id (required). | |
| tags | No | Optional array of tag slugs to apply to the object. | |
| oob_ip | No | IP address id for the out-of-band (OOB) management IP. | |
| serial | No | ||
| status | No | active | |
| tenant | No | ||
| airflow | No | Airflow direction: front-to-rear, rear-to-front, left-to-right, right-to-left, passive, mixed. | |
| cluster | No | Cluster id if this is a host. | |
| comments | No | ||
| latitude | No | GPS latitude (decimal degrees). | |
| location | No | ||
| platform | No | ||
| position | No | Rack position in U. | |
| asset_tag | No | ||
| longitude | No | GPS longitude (decimal degrees). | |
| description | No | ||
| device_type | Yes | Device type id (required). | |
| primary_ip4 | No | IP address id for primary IPv4. | |
| primary_ip6 | No | IP address id for primary IPv6. | |
| vc_position | No | Position within the virtual chassis. | |
| vc_priority | No | Virtual chassis master election priority. | |
| custom_fields | No | Optional object of custom-field slugs -> values. Only include fields defined on your NetBox instance. | |
| config_template | No | Config template id. | |
| response_format | No | Output format: 'markdown' (default, human-readable) or 'json' (full structured payload). Use 'json' when chaining follow-up tool calls. | markdown |
| virtual_chassis | No | Virtual chassis id. | |
| local_context_data | No | Local config context data (JSON object). |