---
title: "Add IP addresses"
method: GET
path: "/addips"
tags: ["IP Addresses", "IPv4 Address Settings"]
---

# Add IP addresses

`GET /addips`

This function adds an IPv4 address or addresses to the server.
When you add an IP address, the system attempts to add an alias of that IP
address to the main network interface. This process rebuilds the IP address
pool, which resides in the `/etc/ipaddrpool` file. The system stores IP addresses
within the `/etc/ips` file. The `ipaliases` service activates those IP addresses
when the server starts.

## Query parameters

- `ips` string, required
- `netmask` string, ipv4, required
- `excludes` string

## Response `200`

HTTP Request was successful.

- object
  - `metadata` object
    - `command` string — The method name called.
    - `output` object
      - `messages` string[] — A list of messages returned from the function.
    - `reason` string — The reason the API function failed when the `metadata.result` field is 0. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success * `0` - Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)