> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Vincular grupos

> Adiciona grupos a uma comunidade

## Conceituação

Com essa API você consegue adicionar outros grupos a uma comunidade.

<Warning>
  Não é possível vincular o mesmo grupo em mais de uma comunidade. Se você enviar 3 grupos e 1 já pertencer a outra comunidade, 2 serão adicionados e o outro retornará um erro indicando que já faz parte de outra comunidade.
</Warning>

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Obrigatórios

<ParamField body="communityId" type="string" required>
  ID da comunidade
</ParamField>

<ParamField body="groupsPhones" type="array" required>
  Array com os IDs/Phones dos grupos a serem vinculados
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "communityId": "98372465382764532938",
  "groupsPhones": ["1345353454354354-group", "1203634230225498-group"]
}
```

***

## Response

### 200

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "success": true
}
```

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

### 415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json".