---
title: "Criar contato"
method: POST
path: "/v2/contacts"
tags: ["conversas-v2-contacts"]
deprecated: true
---

# Criar contato

`POST /v2/contacts`

## Request

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

> **Deprecated.**

⚠️ Recurso depreciado. Prefira integrações com a
[POST /v2/contacts/whatsapp-business-by-brokers](conversas-v2-create-whatsapp-business-contact-by-broker).

Cria um contato genérico.

## Request body

- CreateContactRequest
  - `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`

Contato criado com sucesso

- union
  - object
    - `success` string: Mensagem de sucesso.
  - object
    - `customer` Contact
      - `_id` string, hash
      - `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: Data de nascimento no formato brasileiro (DD/MM/YYYY).
      - `cel_phone` string: Número de telefone do contato.
      - `channel_metadata` object: Integração do WhatsApp a qual o contato está atribuído atualmente.
      - `cnpj` string, nullable: Número de CNPJ do contato.
      - `code` string: Código do contato.
      - `cpf` string, nullable: Número de CPF do contato.
      - `current_wallet` string: Nome da carteira ao qual o contato será inserido.
      - `customizable_field` ContactCustomizableField[], nullable: Campos personalizados do contato. Array vazio quando não houver valores.
        - `info` string
        - `label` string
      - `department_name` string: Nome do setor que o contato será direcionado.
      - `description` string: Descrição.
      - `email` string, email: Endereço de e-mail do contato.
      - `employee` string, hash
      - `full_name` string: Nome completo do contato.
      - `integration` string: Integração do WhatsApp a qual o contato está 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.
      - `last_message_data` object: Última mensagem enviada pelo contato.
        - `channel` 'email' | 'instagram' | 'megasac' | 'messenger' | 'telegram' | 'whatsapp'
        - `content` string: Conteúdo da mensagem.
        - `created_at` string: Data e hora que o contato enviou a mensagem.
        - `type` string: Tipo da mensagem.
      - `rg` string, nullable: Número de RG do contato.
      - `tags` string[]: Tags.
      - `workflow_stage_title` string: Título do Estágio do Workflow ao qual o contato será atribuído.
      - `workflow_title` string: Título do Workflow ao qual o contato será atribuído.
  - object
    - `customer` Contact
      - `_id` string, hash
      - `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: Data de nascimento no formato brasileiro (DD/MM/YYYY).
      - `cel_phone` string: Número de telefone do contato.
      - `channel_metadata` object: Integração do WhatsApp a qual o contato está atribuído atualmente.
      - `cnpj` string, nullable: Número de CNPJ do contato.
      - `code` string: Código do contato.
      - `cpf` string, nullable: Número de CPF do contato.
      - `current_wallet` string: Nome da carteira ao qual o contato será inserido.
      - `customizable_field` ContactCustomizableField[], nullable: Campos personalizados do contato. Array vazio quando não houver valores.
        - `info` string
        - `label` string
      - `department_name` string: Nome do setor que o contato será direcionado.
      - `description` string: Descrição.
      - `email` string, email: Endereço de e-mail do contato.
      - `employee` string, hash
      - `full_name` string: Nome completo do contato.
      - `integration` string: Integração do WhatsApp a qual o contato está 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.
      - `last_message_data` object: Última mensagem enviada pelo contato.
        - `channel` 'email' | 'instagram' | 'megasac' | 'messenger' | 'telegram' | 'whatsapp'
        - `content` string: Conteúdo da mensagem.
        - `created_at` string: Data e hora que o contato enviou a mensagem.
        - `type` string: Tipo da mensagem.
      - `rg` string, nullable: Número de RG do contato.
      - `tags` string[]: Tags.
      - `workflow_stage_title` string: Título do Estágio do Workflow ao qual o contato será atribuído.
      - `workflow_title` string: Título do Workflow ao qual o contato será atribuído.
    - `success` string: Mensagem de sucesso.

## Other responses

- `401`: Access Token missing or invalid
- `403`: Not authorized to access such resource
- `409`: Error to process request
- `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)
