Skip to main content
POST
Criar template
Cria um novo template de PDF com campos dinâmicos (texto, assinatura, checkbox, radio, date, select) em posições específicas. Templates são reutilizáveis — crie um template uma vez e gere múltiplos envelopes a partir dele.

Parâmetros

string
required
Nome do template (ex: "Contrato de Serviços Padrão").
object
required
Arquivo PDF.
array
required
Metadados das páginas do PDF (dimensões do documento original).
array
required
Lista de campos dinâmicos.

Respostas

string
UUID do template criado.
string
Título do template.
string
Nome do arquivo.
integer
Número de páginas.
array
Metadados das páginas.
array
Campos (mesmo shape da requisição).
string
Timestamp de criação (ISO 8601).

Erros

Veja Autenticação e erros.
  • 400: Arquivo inválido, PDF não legível, campo com key duplicado ou inválido.
  • 401: API key/Bearer token inválido.
  • 422: Payload inválido (campos obrigatórios faltando).

Exemplo

Próximas etapas

  1. Listar templates: GET /v1/templates
  2. Criar envelope a partir do template: POST /v1/templates/:uuid/envelopes
  3. Pré-visualizar preenchido: POST /v1/templates/:uuid/fill