---
title: "Add login security record to list"
method: GET
path: "/create_cphulk_record"
tags: ["cPHulk", "Management"]
---

# Add login security record to list

`GET /create_cphulk_record`

This function adds a new record or records to cPHulk's whitelist or blacklist.

## Query parameters

- `ip` IpAddress[], required
  - union
    - string, ipv4
    - string, cidr
    - string, ipv4-ipv4
    - string, ipv6
    - string, cidr
    - string, ipv6-ipv6
- `list_name` 'black' | 'white', required
- `comment` string
- `skip_enabled_check` 0 | 1

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `comment` string — The comment that you included when you called the function.
    - `ip_blocks_removed` integer — The number of IP address blocks that the function deleted.
    - `ips_added` IpAddress[] — An array of IP addresses that the function added to the list.
      - union
        - string, ipv4
        - string, cidr
        - string, ipv4-ipv4
        - string, ipv6
        - string, cidr
        - string, ipv6-ipv6
    - `ips_failed` object — A object of IP addresses that the system failed to add to the list. This object contains one or more IP address returns.
    - `iptable_bans_removed` integer — The number of `iptables` temporary block rules that the function deleted.
    - `list_name` 'black' | 'white' — The cPHulk list's name. * `black` * `white`
    - `requester_ip` union — The IP address of the user or system that requested the addition.
      - string, ipv4
      - string, ipv6
    - `requester_ip_is_whitelisted` 0 | 1 — Whether the requester's IP address exists on cPHulk's whitelist. * `1` - Whitelisted. * `0` - Not whitelisted.
  - `metadata` object
    - `command` string — The method name called.
    - `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)