Skip to content
Dinamo Wellness API

Criar aluno

POST
/alunos
 
curl --request POST \
  --url https://api-wellness.dinamopro.ai/v1/alunos \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --data '{ "p_nome": "Maria Santos", "p_email": "maria@example.com", "p_telefone": "11999998888", "p_academia_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "p_modalidade": "presencial" }'

Cria um novo aluno no tenant.

Nota: não inclua p_api_key no body — esse campo foi removido na v1. A chave vai apenas no header X-Api-Key.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
p_nome
required
string
>= 1 characters <= 200 characters
p_email
required
string format: email
<= 200 characters
p_telefone
string
/^\d{10,13}$/
p_sexo
string
Allowed values: M F Outro
p_data_nascimento
string
/^\d{4}-\d{2}-\d{2}$/
p_academia_id
string format: uuid
p_modalidade
string
Allowed values: presencial online hibrido
Example 
{
  "p_nome": "Maria Santos",
  "p_email": "maria@example.com",
  "p_telefone": "11999998888",
  "p_academia_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "p_modalidade": "presencial"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Aluno criado com sucesso.

Media type application/json
object
id
string format: uuid
nome
string
email
string format: email
ativo
boolean
academia_id
string format: uuid
criado_em
string format: date-time
Example generated
{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "nome": "example",
  "email": "hello@example.com",
  "ativo": true,
  "academia_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "criado_em": "2026-04-15T12:00:00Z"
}

400

Section titled “400 ”

Header obrigatório ausente ou body inválido.

Media type application/json
object
error
string
Allowed values: Missing X-Api-Key header Invalid JSON body
Example 
{
  "error": "Missing X-Api-Key header"
}

401

Section titled “401 ”

API key inválida, inativa ou sem permissão para o endpoint.

Media type application/json
object
error
string
Example 
{
  "error": "API Key inválida"
}

422

Section titled “422 ”

Um ou mais parâmetros de query ou campos do body falharam na validação de schema.

Media type application/json
object
error
object
key
additional properties
Array<string>
Example 
{
  "error": {
    "ativo": [
      "Invalid enum value. Expected 'true' | 'false', received 'sim'"
    ]
  }
}