---
title: "Create scan group"
method: POST
path: "/teams/{team_id}/scan_groups"
tags: ["Scan Groups"]
---

# Create scan group

`POST /teams/{team_id}/scan_groups`

## Request

- Base URL: `https://tlsradar.com/api/v1`
- URL: `https://tlsradar.com/api/v1/teams/{team_id}/scan_groups`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://tlsradar.com/oauth/authorize`, token URL `https://tlsradar.com/oauth/token`, scopes: `read`, `write`)
  - HTTP bearer

Creates a new scan group with domains to monitor

## Path parameters

- `team_id` string, uuid, required

## Request body

- object
  - `scan_group` object, required
    - `friendly_name` string, required: Name for the scan group
    - `scan_port` integer: Port to scan
    - `hosts` string: Comma or space-separated list of domains

## Response `201`

Scan group created

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/tlsradar/apis/tls-radar-api.md) · [All operations](https://skmtc.dev/tlsradar/apis/tls-radar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlsradar/apis/tls-radar-api/revisions/ecf1eb879b34?raw)