> ## 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.

# Criando canais

> Cria um novo canal no WhatsApp

## Conceituação

Este método é responsável por criar um canal.

<Tip>
  Não é possível adicionar imagem durante a criação, utilize o método de atualizar imagem do canal depois.
</Tip>

***

## 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>

### Body

<ParamField body="name" type="string" required>
  Nome do canal
</ParamField>

<ParamField body="description" type="string">
  Descrição do canal
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "name": "Nome do canal",
  "description": "Descrição do canal"
}
```

***

## Response

### 201

<ResponseField name="id" type="string">
  ID do canal criado
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "id": "999999999999999999@newsletter"
}
```

<Info>
  O ID do canal sempre deve conter o sufixo **@newsletter**, pois esse é o padrão utilizado pelo próprio WhatsApp.
</Info>

### 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".
