Crie um novo processo
Cria um novo processo judicial no sistema.
Campos obrigatórios:
users_id- ID do usuário responsável (deve pertencer ao escritório)customers_id- Array de IDs de clientes (mínimo 1, devem pertencer à conta)stages_id- ID da fase processual (deve pertencer à conta)type_lawsuits_id- ID do tipo de processo (deve pertencer à conta)
Validações importantes:
process_numberdeve ser um número CNJ válido e oficialmente distribuído. Aceita apenas números reais de processos judiciais.datedeve ser no formato YYYY-MM-DD (valida calendário)folderaceita no máximo 30 caracteres- Todos os IDs são validados se pertencem ao escritório autenticado
customers_iddeve ter pelo menos 1 elemento (array vazio não é aceito)
Authorization
BearerAuth In: header
Request Body
application/json
[Required] ID do usuário responsável pelo processo. Deve existir e pertencer ao escritório autenticado. Aceita string ou integer.
[Required] Array de IDs de clientes associados ao processo. Deve conter pelo menos 1 cliente. Todos os IDs devem pertencer à conta autenticada.
1 <= items[Required] ID da fase processual. Deve existir e pertencer à conta autenticada. Aceita string ou integer.
[Required] ID do tipo de processo. Deve existir e pertencer à conta autenticada. Aceita string ou integer.
[Optional] Número do processo no formato CNJ (formato: NNNNNNN-DD.AAAA.J.TR.OOOO). Deve ser um número CNJ real e oficialmente distribuído. A API valida se o número existe nas bases do Poder Judiciário. Opcional.
[Optional] Número de protocolo do processo. Campo livre, sem validação de formato.
[Optional] Nome da pasta para organização do processo. Máximo 30 caracteres.
length <= 30[Optional] Data do processo no formato YYYY-MM-DD. A data deve ser válida no calendário.
date[Optional] Observações detalhadas sobre o processo, incluindo histórico, notas importantes e contexto adicional para referência futura.
Response Body
application/json
application/json
curl -X POST "https://app.advbox.com.br/api/v1/lawsuits" \ -H "Content-Type: application/json" \ -d '{ "users_id": "123456", "customers_id": [ 1234567 ], "stages_id": "2345678", "type_lawsuits_id": "1234567", "protocol_number": "PROT-2026-001", "folder": "Pasta Cliente A", "date": "2026-01-02", "notes": "Processo iniciado para cliente referente a disputa contratual" }'{
"success": true,
"lawsuits_id": 12358596
}{
"message": "The given data was invalid.",
"errors": {
"users_id": [
"The responsible user is required"
]
}
}