Entrar

Criar usuário

POST https://{organization}.myguper.com/api/connect/user

Vincula credenciais de login do Connect (login + password) a uma pessoa já cadastrada no Register.

Este é o segundo passo do fluxo de onboarding de usuário. O primeiro é emitir o token de convite para essa pessoa em Criar convite — o token é entregue ao novo usuário (link de e-mail, magic link, etc.) e precisa ser enviado de volta aqui junto com as credenciais.

O Connect descriptografa o token com a chave privada, valida a organização e o personId que ele carrega, e só então grava o registro de User. O personId do User retornado é o mesmo idPerson usado no convite — esse é o vínculo entre os dois serviços.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

Most Connect endpoints require a valid x-guper-authorization token. Token issuance itself (/api/connect/auth) is the exception — it uses the x-guper-apikey and x-guper-apisecret credentials.

Cabeçalhos

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Corpo da requisição

Content-Type: application/json

{
    "inviteToken": "<inviteToken>",
    "login": "maria.silva",
    "password": "S3cretPass!",
    "type": "user"                                              // optional
}

Respostas

{
    "organization": "acme",
    "login":        "maria.silva",
    "type":         "user",
    "personId":     44,
    "pass":         "**************",
    "dateTime":     "2026-05-01T12:34:56-03:00"
}

Relacionados

Copied to clipboard