---
title: "/v2/publicacoes/destinatario-list"
method: POST
path: "/v2/publicacoes/destinatario-list"
---

# /v2/publicacoes/destinatario-list

`POST /v2/publicacoes/destinatario-list`

## Request

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

endpoint para adicionar destinatários em um documento

## Request body

- object
  - `idDocumento` integer
  - `destinatarios` object[]
    - `email` string, required
    - `acao` integer, required: 0 = assinar, 1= validar, 2= testemunhar, 4 = Assinar com certificado (A1/A3) (4 ainda não disponível para TipoAutenticacao 2)
    - `workflow` integer: ordenação de assinaturas
    - `papelAssinante` string: Papel na assinatura. Ex: "como locatário", "como fiador" etc...
    - `nomeCompleto` string: Obrigatório para TipoIdentificação = 2;
    - `tipoAutenticacao` integer: 1 - Login no sistema | 2 - Verificação de código
    - `tipoIdentificacao` integer: 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
    - `tipoEnvioCodigo` integer: 1 - Email | 2 - WhatsApp | 3 - Sms
    - `telefone` string: Número de telefone caso seja utilizado algum tipo de envio dos tipos WhatsApp ou Sms

## Response `200`

200

- object
  - `success` boolean
  - `data` unknown
  - `message` string

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