Actions41
- Alarm Actions
- Alarm Category Actions
- Data Collection Actions
- Event Template Actions
- Find Actions
- Object Actions
- Scheduled Task Actions
- Server Actions
- User Actions
Find → Find MAC Address
AI-generatedSummary
Locates a full or partial MAC address in the NetXMS network topology by calling GET /v1/find/mac-address, returning the matches the server reports.
Inputs
- MAC Address (required) — Full or partial MAC address to search for (e.g. 00:1A:2B:3C:4D:5E). Sent as the macAddress query parameter.
- Additional Fields > Result Limit — Maximum number of results to return. Defaults to 100 in the UI; sent as searchLimit only when non-zero.
- Additional Fields > Include Object Details — When set, sent as includeObjects to ask the server to include full object information in the response. Sent whenever the field is present, including when false.
Output shape
The server's JSON response, converted to n8n items. An array response becomes one item per element, and a single object becomes one item. Each item is linked to its input item.
The exact response fields come from the NetXMS REST API and are not defined in the node. The node logs in to NetXMS once per execution using the credentials' username and password, then uses the session token for every input item. If Continue On Fail is enabled, a failed item returns {error: message} instead of stopping the workflow.
Examples
Example 1: Find which switch port a device is connected to, given its MAC address from a DHCP log.
Resource: Find; Operation: Find MAC Address; MAC Address: {{$json.mac}}; Include Object Details: true
Example 2: Search by vendor prefix (OUI) to list devices from one manufacturer.
MAC Address: 00:1A:2B; Result Limit: 50