Entrar

Unirse

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

Registra la entrada (o reentrada) de una persona en un programa tier.

La mayoría de las memberships se crean automáticamente por el hook de tag: asignar a la persona una tag listada en tag_tier_filter dispara un join. Este endpoint cubre los casos en que la membership debe crearse manualmente (acción del admin, import, flujo especial de inscripción).

Idempotente:

  • Sin fila → INSERT, history joined.
  • Fila activa (leftAt IS NULL) → no-op.
  • Fila cerrada (leftAt IS NOT NULL) → limpia leftAt, actualiza joinedAt, history rejoined.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

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

Encabezados

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.

Cuerpo de la petición

Content-Type: application/json

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

Respuestas

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