add_to_address_list
Adds an IP address or subnet to a named MikroTik firewall address-list, enabling management of existing list entries without modifying firewall rules.
Instructions
Add address (an IP or subnet) to a named firewall address-list
(/ip/firewall/address-list).
IMPORTANT: this only manages the list - it does NOT create or
modify any firewall rule. Adding an address here only blocks or
allows traffic if a /ip/firewall/filter (or NAT) rule on the
device already references list_name (e.g.
src-address-list=list_name, action=drop). See README's
"Blocking/allowing a client via address lists" section.
WRITE tool, guarded: blocked entirely unless the server is running
with MIKROTIK_ALLOW_WRITE=true. Call with confirm=False (the
default) to get a before/after preview without changing anything;
call again with confirm=True to actually apply it. Errors clearly
(without creating anything) if this exact list_name+address pair
already exists on the device - it never creates a duplicate.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| comment | No | ||
| confirm | No | ||
| timeout | No | ||
| list_name | Yes | ||
| device_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||