---
title: "Criar múltiplos funcionários"
method: POST
path: "/v2/employees/bulk"
tags: ["conversas-v2-employees"]
---

# Criar múltiplos funcionários

`POST /v2/employees/bulk`

## Request

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

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

Criar funcionários 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

- BulkCreateEmployeesRequest
  - `employees` object[], required: Lista de funcionários a serem criados.
    - `avatar` string: Avatar do funcionário.
    - `email` string, email, required: Endereço de e-mail do funcionário.
    - `is_root` boolean: Indica que este é um funcionário primário do tipo "root".
    - `metadata` object, nullable: Informações específicas para o funcionário.
    - `name` string, required: Nome completo do funcionário.
    - `registration` string: Matrícula do funcionário.
    - `role` string, required: Papel do funcionário no RD Conversas.
    - `settings` object: Outras configurações do usuário.
    - `vortico_wallets` string: Carteiras do employee no vortico.

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