---
title: "Add a new client"
method: POST
path: "/clients/add"
tags: ["clients"]
---

# Add a new client

`POST /clients/add`

## Request

- Base URL: `/control` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/control/clients/add`
- Auth: HTTP basic

## Request body

- Client: Client information.
  - `name` string: Name
  - `ids` string[]: IP, CIDR, MAC, or ClientID.
  - `use_global_settings` boolean
  - `filtering_enabled` boolean
  - `parental_enabled` boolean
  - `safebrowsing_enabled` boolean
  - `safesearch_enabled` boolean
  - `use_global_blocked_services` boolean
  - `blocked_services` string[]
  - `upstreams` string[]
  - `tags` string[]

## Response `200`

OK.

---

[API](https://skmtc.dev/guardllamanet/apis/adguard-home.md) - [All operations](https://skmtc.dev/guardllamanet/apis/adguard-home/llms.txt) - [OpenAPI document](https://skmtc.dev/guardllamanet/apis/adguard-home/revisions/14ff21aeb363?raw)