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

# Criar múltiplos contatos

`POST /v2/contacts/bulk`

ℹ️ 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` unknown
      - `complement` unknown
      - `country` unknown
      - `district` unknown
      - `number` unknown
      - `state` unknown
      - `street` unknown
      - `zip_code` unknown
    - `birth_date` unknown
    - `cel_phone` string, required — Número de telefone do contato.
    - `cnpj` unknown
    - `code` unknown
    - `cpf` unknown
    - `department_name` unknown
    - `description` unknown
    - `email` unknown
    - `full_name` unknown
    - `integration` string — Integração do WhatsApp a qual o contato será criado.
    - `job` JobInfo
      - `cnpj` unknown
      - `company` unknown
      - `department` unknown
      - `email` unknown
      - `occupation_area` unknown
      - `phone` unknown
      - `site` string, url — Website do negócio.
      - `title` unknown
    - `rg` unknown
    - `tags` string[] — Tags que serão atribuídas ao contato.
    - `wallet_name` unknown
    - `workflow_stage_title` unknown
    - `workflow_title` unknown

## 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.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)