Skip to main content
POST
Criar grupo de signatários
Cria um novo grupo de signatários contendo uma lista ordenada de contatos. Use para agrupar signatários frequentes (ex.: “Diretoria”, “Testemunhas”) e adicioná-los em massa aos envelopes. Autenticação: x-api-key no header. Também aceita Authorization: Bearer.

Parâmetros

string
required
Nome do grupo (ex.: "Diretoria"). Deve ser único no projeto.
array
required
Array de UUIDs de contatos (mínimo 1). Ordem é preservada.

Respostas

Retorna o objeto do grupo criado (201 Created).

Erros

Veja Autenticação e erros.
  • 400: Lista vazia, ou um dos contatos não pertence à agenda do projeto.
  • 409: Grupo com este nome já existe no projeto.

Exemplo

Importante

  • Ordem importa: os contatos são adicionados na ordem fornecida.
  • Contatos devem existir: todos os UUIDs devem estar na agenda do projeto.
  • Nome único: nomes são únicos por projeto (case-insensitive).

Relacionado