---
title: "Create Auth Challenge"
method: POST
path: "/account/auth/challenges"
tags: ["account"]
---

# Create Auth Challenge

`POST /account/auth/challenges`

## Request

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

## Request body

- AuthChallengeCreateRequest
  - `method` 'email_otp' | 'phone_otp' | 'wechat_qr' | 'wechat_browser', required
  - `subject` string, nullable
  - `visitor_context_token` string, nullable
  - `country_code` string, nullable
  - `preferred_locale` string, nullable
  - `activation_return` string, nullable

## Response `201`

Successful Response

- AuthChallengeResponse
  - `challenge_id` string, required
  - `method` 'email_otp' | 'phone_otp' | 'wechat_qr' | 'wechat_browser', required
  - `status` 'pending' | 'authenticated' | 'consumed' | 'expired', required
  - `mode` 'real' | 'mock' | 'fallback', required
  - `expires_at` string, date-time, required
  - `country_code` string, required
  - `locale` string, required
  - `login_methods` LoginMethodsResponse, required
    - `primary` string[], required
    - `other` string[], required
  - `verification_hint` string, nullable
  - `mock_code` string, nullable
  - `qr_url` string, nullable
  - `completion_token` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)