ADVBOXAPI ADVBOX
Lawsuits

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_number deve ser um número CNJ válido e oficialmente distribuído. Aceita apenas números reais de processos judiciais.
  • date deve ser no formato YYYY-MM-DD (valida calendário)
  • folder aceita no máximo 30 caracteres
  • Todos os IDs são validados se pertencem ao escritório autenticado
  • customers_id deve ter pelo menos 1 elemento (array vazio não é aceito)

Campos derivados automaticamente (não enviar):

  • group_id / group — derivados de type_lawsuits_id
  • steps_id / step — derivados de stages_id
POST
/lawsuits

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

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"  }'
{
  "success": true,
  "lawsuits_id": 12358596
}
{
  "error": "Unauthenticated."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "customers_id": [
      "The customer is required."
    ],
    "users_id": [
      "The responsible user is required"
    ],
    "stages_id": [
      "The stage is required"
    ],
    "type_lawsuits_id": [
      "The type lawsuit is required"
    ]
  }
}

{
  "message": "Too Many Requests"
}
Empty