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

# /v1/contatos

`POST /v1/contatos`

## Request

- Base URL: `https://totvssign.staging.totvs.app/identityintegration`
- URL: `https://totvssign.staging.totvs.app/identityintegration/v1/contatos`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/docs/v1/contatos/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/totvs/apis/api-identityintegration-autentica-o.md) - [All operations](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/llms.txt) - [OpenAPI document](https://skmtc.dev/totvs/apis/api-identityintegration-autentica-o/revisions/0f43855140b5?raw)