---
title: "/v1/contatos"
method: POST
path: "/v1/contatos"
---

# /v1/contatos

`POST /v1/contatos`

endpoint para cadastrar um novo contato na agenda do usuário logado.

## Request body

- object
  - `nomeCompleto` string, required — Nome que será exibido para o contato
  - `email` string, required — e-mail do contato a ser cadastrado
  - `acao` integer — 0 = assinar, 1= validar, 2= testemunhar, 3= Observar, 4 = Assinar com certificado (A1/A3)
  - `idGrupo` integer — Id do grupo que o contato será adicionado
  - `papelAssinante` string — Papel na assinatura. Ex: "como locatário", "como fiador" etc...
  - `tipoAutenticacao` integer — 1 - Login no sistema | 2 - Via envio de código por e-mail
  - `tipoIdentificacao` string — 1 = Brasil (CPF ou CNPJ) | 2 = (Id Internacional) | 3 = Não possui (Não solicitar)
  - `identificacao` string — Identificacao de acordo com o que foi definido no "tipoIdentificacao"
  - `tipoEnvioDocumento` integer — 1 - Email | 2 - WhatsApp | 3 - Sms
  - `tipoEnvioCodigo` integer — 1 - Email | 2 - WhatsApp | 3 - Sms
  - `telefone` string — Telefone do usuário para caso o tipo envio seja WhatsApp ou Sms

## Response `201`

201

- object
  - `code` integer
  - `success` boolean
  - `data` object
    - `id` integer
    - `nomeCompleto` string
    - `email` string
    - `acao` integer
    - `idGrupo` integer
    - `papelAssinante` string
    - `tipoAutenticacao` integer
    - `tipoIdentificacao` integer
    - `identificacao` unknown
    - `tipoEnvioCodigo` unknown
    - `tipoEnvioDocumento` integer
    - `telefone` unknown
  - `errors` unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/totvs/apis/api-identityintegration-autentica-o.md) · [All operations](https://skmtc.net/totvs/apis/api-identityintegration-autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totvs/api-identityintegration-autentica-o/revisions/0f43855140b5/schema)