---
title: "Create a new Gateway"
method: POST
path: "/gateway_manager/v1/gateways"
tags: ["Gateway Manager"]
---

# Create a new Gateway

`POST /gateway_manager/v1/gateways`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gateway_manager/v1/gateways`
- Auth: none declared

Creates a new gateway within the database.

## Request body

- object
  - `gateway` GatewayManagerV1GatewaysPostRequestBodyContentApplicationJsonSchemaGateway
    - `cluster_id` string, required
    - `description` string
    - `enabled` boolean, required
    - `readonly` boolean, required
    - `certificates` string[]: Object Ids for certificates that can be used by this gateway
    - `groups` string[], required: An array of the names of the groups that will be associated with this gateway. Any group that is associated with this gateway will be able to actions on this gateway per the roles associated with that particular group

## Response `200`

result of adding gateway

- GatewayManagerCreateGatewayResponse200
  - `state` string
  - `message` string
  - `id` string

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Manager` added
  - api tag `gatewayManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gateway_manager/v1/gateways/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)