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

# Adicionar contatos

> Salva contatos do WhatsApp na lista de contatos do celular

## Conceituação

Este método é responsável por salvar os contatos do WhatsApp em sua lista de contatos no celular.

<Warning>
  **Sobre esse recurso**

  O método para adicionar contatos à lista do WhatsApp só funcionará para contas que já receberam a atualização necessária. Certifique-se de que sua conta **do WhatsApp** tenha recebido a atualização antes de utilizar este recurso. Caso contrário, a operação não será concluída com sucesso.

  Além disso, é necessário permitir que o WhatsApp adicione contatos diretamente no celular. Para isso, vá até as configurações de privacidade do seu aplicativo e ajuste as permissões de forma que o WhatsApp possa acessar e modificar seus contatos.
</Warning>

#### Exemplo nas configurações

<div style={{ display: "flex", justifyContent: "center", gap: "16px" }}>
  <img src="https://mintcdn.com/z-api-8aa3bb40/4dxajBiLV0HF17QH/images/add-contacts1.jpeg?fit=max&auto=format&n=4dxajBiLV0HF17QH&q=85&s=7b1f4e162f28a1e15a2c154c2aa44b44" width="300" data-path="images/add-contacts1.jpeg" />

  <img src="https://mintcdn.com/z-api-8aa3bb40/4dxajBiLV0HF17QH/images/add-contacts2.jpeg?fit=max&auto=format&n=4dxajBiLV0HF17QH&q=85&s=3ffcdc6e9c232c1c1519397731aad40a" width="300" data-path="images/add-contacts2.jpeg" />
</div>

***

## 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="firstName" type="string" required>
  Nome do contato que vai ser adicionado na agenda
</ParamField>

<ParamField body="phone" type="string" required>
  Número do contato que vai ser adicionado na agenda
</ParamField>

### Opcionais

<ParamField body="lastName" type="string">
  Sobrenome do contato que vai ser adicionado na agenda
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
[
  {
    "firstName": "Contato 1",
    "lastName": "Sobrenome 1",
    "phone": "554499999999"
  },
  {
    "firstName": "Contato 2",
    "lastName": "Sobrenome 2",
    "phone": "554499998888"
  }
]
```

***

## Response

### 200

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

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