auth

Register User

Changed on

Register the authenticated user in our system.

This endpoint should be called by the frontend after Supabase authentication to create the user record in our Users service. It uses the Supabase user ID (from JWT 'sub' claim) as the primary key.

Safe to call multiple times. If user already exists, returns 200 OK. The response includes the frontend's next routing step:

  • next_step="email" for phone-only users who must collect a primary email
  • next_step="app" for complete users

Requires authentication via Bearer token (Supabase JWT). A guest (anonymous-session) token is refused: a guest becomes an account through /auth/add-identity and /auth/verify-identity, then registers with the refreshed, non-anonymous session.

post/auth/register

Request

  • Base URL: https://api.helloaxel.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.helloaxel.com/auth/register
  • Auth: HTTP bearer

Request body

promo_codestring nullable
referral_codestring nullable
sms_opted_inboolean
timezonestring nullable

Response

Successful Response

idstring uuid required
statusstring required
account_state'pending_email' | 'complete' required
next_step'email' | 'app' required
is_new_userboolean required
forwarding_slugstring required
reply_slugstring nullable
created_atstring date-time required

Changes

  • 6d10c134a61dRevision changes
    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

  • 5d2121d26b96Revision changes
    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////

    • info

      added the new optional request property ///////