---
title: "Criar múltiplos contatos"
method: POST
path: "/v2/contacts/bulk"
tags: ["conversas-v2-contacts"]
---

# Criar múltiplos contatos

`POST /v2/contacts/bulk`

## Request

- Base URL: `https://api.tallos.com.br`
- URL: `https://api.tallos.com.br/v2/contacts/bulk`
- Auth: HTTP bearer

ℹ️ API disponível apenas para o plano Advanced.

Criar contatos em massa.

Esta ação dispara uma rotina assíncrona.
Os dados entram em uma fila e são processados de maneira assíncrona.
Para consultar o processamento desta fila, utilize o `job_id` retornado na requisição do recurso de [consulta de rotinas](/conversas-v2-get-job).

## Request body

- BulkCreateContactsRequest
  - `contacts` CreateContactRequest[], required: Lista de contatos a serem criados.
    - `address` Address
      - `city` string, nullable: Cidade do endereço.
      - `complement` string, nullable: Informações complementares para o endereço.
      - `country` string, nullable: País do endereço.
      - `district` string, nullable: Bairro/Distrito do endereço.
      - `number` string, nullable: Número do endereço.
      - `state` string, nullable: Estado/Província do endereço.
      - `street` string, nullable: Rua do endereço.
      - `zip_code` string, nullable: Código Postal do endereço.
    - `birth_date` string, nullable: Data de nascimento no formato brasileiro (DD/MM/YYYY).
    - `cel_phone` string, required: Número de telefone do contato.
    - `cnpj` string, nullable: Número de CNPJ do contato.
    - `code` string, nullable: Código do contato.
    - `cpf` string, nullable: Número de CPF do contato.
    - `department_name` string, nullable: Nome do setor a qual o contato será direcionado.
    - `description` string, nullable: Descrição.
    - `email` string, email, nullable: Endereço de e-mail do contato.
    - `full_name` string, nullable: Nome completo do contato.
    - `integration` string: Integração do WhatsApp a qual o contato será criado.
    - `job` JobInfo
      - `cnpj` string, nullable: CNPJ ou outro identificador único do negócio.
      - `company` string, nullable: Companhia de contato.
      - `department` string, nullable: Departamento correspondente.
      - `email` string, email, nullable: Endereço de e-mail para contato.
      - `occupation_area` string, nullable: Área de ocupação.
      - `phone` string, nullable: Telefone para contato.
      - `site` string, url: Website do negócio.
      - `title` string, nullable: Título do trabalho.
    - `rg` string, nullable: Número de RG do contato.
    - `tags` string[], nullable: Tags que serão atribuídas ao contato.
    - `wallet_name` string, nullable: Nome da carteira a qual o contato será atribuído.
    - `workflow_stage_title` string, nullable: Título da etapa de workflow a qual o contato será atribuído.
    - `workflow_title` string, nullable: Título do workflow a qual o contato será atribuído.

## Response `200`

Rotina de criação iniciada

- JobResponse
  - `job` Job, required
    - `completedItems` integer: Total de itens processados.
    - `failedItems` integer: Total de itens processados com falha.
    - `id` string: ID do job.
    - `pendingItems` integer: Total de itens pendente de processamento.
    - `result` unknown[]: Resultado da operação.
      - unknown
    - `status` 'awaiting' | 'completed' | 'failed' | 'processing': Status do job.
    - `successfulItems` integer: Total de itens processados com sucesso.
    - `totalItems` integer: Total de itens que irá processar.

## Other responses

- `400`: Bad request
- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `404`: Resource not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-conversas-api-v2/revisions/730a895096d0?raw)