---
title: "/v1/grupos"
method: POST
path: "/v1/grupos"
---

# /v1/grupos

`POST /v1/grupos`

## Request

- Base URL: `https://totvssign.staging.totvs.app/identityintegration`
- URL: `https://totvssign.staging.totvs.app/identityintegration/v1/grupos`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/docs/v1/grupos/post.ts> (a function with typed inputs; its response is checked against the schema)

endpoint para criar um grupo de contatos

## Request body

- object
  - `nome` string, required: Nome para o grupo de contatos
  - `idsContatos` integer[]: Listagem de contatos para serem inclusos no grupo

## Response `201`

201

- object
  - `code` integer
  - `success` boolean
  - `data` object
    - `quantidadeContatos` integer
    - `id` integer
    - `nome` string
  - `errors` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o.md) - [All operations](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/llms.txt) - [OpenAPI document](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/revisions/0f43855140b5?raw)