Entrar

Entrar

POST https://{organization}.myguper.com/api/register/membership

Registra a entrada (ou reentrada) de uma person em um programa tier.

A maioria das memberships é criada automaticamente pelo hook de tag: atribuir ao person uma tag listada em tag_tier_filter dispara um join. Este endpoint cobre casos em que a membership precisa ser criada manualmente (ação do admin, import, fluxo especial de cadastro).

Idempotente:

  • Sem linha → INSERT, history joined.
  • Linha ativa (leftAt IS NULL) → no-op.
  • Linha encerrada (leftAt IS NOT NULL) → limpa leftAt, atualiza joinedAt, history rejoined.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

Send your user token in the x-guper-authorization header.

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

{
    "person": 4131293,
    "tierConfig": 1,
    "joinedAt": "2026-05-27T10:00:00-03:00",                    // optional
    "source": "manual",                                         // optional
    "sourceRef": "admin:42"                                     // optional
}

Respostas

{ "action": "joined" }
Copied to clipboard