/partners/v1/beneficiaries
Incluir uma vida
Inclui uma pessoa na sua empresa e pede a liberação do acesso. Responde 202 sem esperar a liberação, com a vida e o status atual, e o header Location com a URL da vida.
- Mandar o mesmo CPF de novo não duplica. Se a vida já está ativa, em liberação ou cadastrada (standby), só e-mail, telefone e endereço são atualizados: nome e data de nascimento ficam como estavam.
- Se a vida estava desativada ou com falha na liberação, a Pump tenta liberar de novo e grava o nome e a data de nascimento enviados. É assim que se reativa alguém.
curl -X POST "https://api.pump.com.br/partners/v1/beneficiaries" \
-H "X-Api-Key: $PUMP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"cpf": "12345678909",
"name": "Maria Souza",
"birthDate": "1990-04-12",
"email": "maria.souza@empresa.com.br",
"phone": "11987654321",
"address": {
"street": "Avenida Paulista",
"number": "1000",
"complement": "Sala 12",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zipCode": "01310100"
}
}'
{
"cpf": "12345678909",
"name": "Maria Souza",
"birthDate": "1990-04-12",
"email": "maria.souza@empresa.com.br",
"phone": "11987654321",
"address": {
"street": "Avenida Paulista",
"number": "1000",
"complement": "Sala 12",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zipCode": "01310100"
}
}
{
"id": "8f3c2a1e-5b7d-4c9a-9e21-6d4f0b8a7c35",
"cpf": "12345678909",
"name": "Maria Souza",
"birthDate": "1990-04-12",
"email": "maria.souza@empresa.com.br",
"phone": "11987654321",
"address": {
"street": "Avenida Paulista",
"number": "1000",
"complement": "Sala 12",
"neighborhood": "Bela Vista",
"city": "São Paulo",
"state": "SP",
"zipCode": "01310100"
},
"status": "pending_activation",
"createdAt": "2026-11-12T14:03:21Z",
"updatedAt": "2026-11-12T14:03:21Z"
}