MikroTik API icon

MikroTik API

Community Node for MikroTik RouterOS API

Actions67

Firewall Address List → Add

AI-generated

Summary

Adds an IP address to a MikroTik firewall address list.

Inputs

  • listName — Name of the firewall address list to which the address will be added (defaults to 'Blacklist').
  • ipAddressField (required) — IP address or address with subnet (e.g. 192.168.88.1/24) to add to the list.
  • commentText — Optional comment to attach to the entry.
  • options — Connection settings: number of attempts, delay between attempts, whether to sanitize response keys, and a custom tag for the command.

Output shape

array of items

Each returned item contains a JSON field with the MikroTik API response for the added address‑list entry, plus metadata (resource, operation, count).

Examples

Example 1: Block a single IP

listName='Blacklist', ipAddressField='203.0.113.5', commentText='Known attacker'

Example 2: Add a subnet to a whitelist

listName='Whitelist', ipAddressField='10.0.0.0/16', commentText='Internal network'

Links

Discussion