---
title: "POST Create lote request"
method: POST
path: "/api/lotes/requestsss"
---

# POST Create lote request

`POST /api/lotes/requestsss`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/lotes/requestsss`
- Auth: API key in header `Authorization`

Com esse método é possível **enviar um lote de documentos para assinatura**.

Com o uso de lotes, você pode agrupar e enviar **vários documentos de uma só vez**, otimizando o processo de coleta de assinaturas.

Ideal para fluxos em que múltiplos documentos precisam ser assinados simultaneamente por um ou mais participantes.

## Request body

- object
  - `chain` boolean: Se a solicitação é em cadeia, ou seja, deve respeitar a ordem dos e-mails para envio ou se será enviada para todos ao mesmo tempo
  - `lote_id` integer, required: Id do lote que será usado para criar o lote request
  - `email` string[], required: E-mails para envio, mínimo 1
  - `sender` integer: Id do colaborador que está enviando este documento, caso não seja passado, o documento será enviado pela conta do admin da empresa
  - `subject` string: Assunto enviado no e-mail
  - `message` string, required: Mensagem enviada para o destinatário
  - `expire_date` string: Deve ser uma data válida no formato Y-m-d H:i:s e posterior ao momento atual
  - `due_months` string: A validade do documento em meses, por exemplo, um contrato com 12 meses de validade. Nós iremos monitorar a data e avisaremos antes do vencimento, para que possam refazer a solicitação e reenviar para assinatura
  - `silent_mode` boolean: Quando ativado (True), o request não gera um e-mail para o cliente. Apenas o URL de assinatura e o e-mail serão retornados

## Response `200`

200

- object
  - `data` object[]
    - `id` integer
    - `signing_key` string
    - `email` string
    - `message` string
    - `sender` integer
    - `expire_date` unknown
    - `send_time` string
    - `update_time` string
    - `created_at` string
    - `status` string
    - `lote_id` integer
    - `url` string
  - `message` string

## Other responses

- `404`: 404

## Changes

- **2026-11-03** `3db1513040ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/lotes/requestsss/post.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)