---
title: "Create a rule group"
method: POST
path: "/v1/firewalls/groups"
tags: ["public", "firewalls"]
---

# Create a rule group

`POST /v1/firewalls/groups`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/firewalls/groups`
- Auth: API key in header `Authorization`

Creates an empty group.

## Request body

- FirewallCreateGroupRequest
  - `description` string
  - `name` string

## Response `201`

Created

- FirewallPublicGroup
  - `created_at` string
  - `description` string
  - `id` string
  - `name` string
  - `rules` FirewallPublicRule[]
    - `action` string
    - `conn_state` string
    - `created_at` string
    - `description` string
    - `direction` string
    - `dst_cidr` string
    - `enabled` boolean
    - `id` string
    - `ip_version` string
    - `name` string
    - `policy_id` string
    - `port_max` integer
    - `port_min` integer
    - `position` integer
    - `protocol` string
    - `src_cidr` string
    - `updated_at` string
  - `updated_at` string

## Other responses

- `400`: invalid request body
- `401`: invalid or missing API key
- `403`: the key lacks firewall:write
- `404`: no such resource, or it belongs to another account
- `422`: validation_error — the request is well-formed but not acceptable

---

[API](https://skmtc.dev/vozora/apis/vozora-api.md) · [All operations](https://skmtc.dev/vozora/apis/vozora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vozora/apis/vozora-api/revisions/56f15734fc5a?raw)