---
title: "Loginorsignup"
method: POST
path: "/api/v1/auth"
tags: ["users"]
---

# Loginorsignup

`POST /api/v1/auth`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/auth`
- Auth: none declared

## Request body

- AuthRequestDTO
  - `marketing_context` object, nullable
  - `type` 'native' | 'sso', required
  - `loginMethod` 'login' | 'signup' | 'otp_login' | 'otp_signup'
  - `email` string, nullable
  - `password` string, nullable
  - `idToken` string, nullable
  - `name` string, nullable
  - `domain_id` string, nullable, required
  - `ref_id` string, nullable
  - `ref_link` string, nullable
  - `redirect_to` string, nullable
  - `from_appsumo` boolean, nullable
  - `site_ref` string, nullable
  - `phone` string, nullable
  - `otp` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 37 revisions in range; 1 not diffed.

- **2026-09-28** `461ae7e5d079`: 1 info
  - added the new optional request property `marketing_context`

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/auth/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)