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

# /v2/publicacoes/destinatario-list

`POST /v2/publicacoes/destinatario-list`

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