Sign in
auth

Register User

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).

post/auth/register

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