Skip to main content

​
Overview

Creates a new user account. After registering, use the login endpoint to obtain a Bearer token.

​
Request

Method: POST URL: /api/v1/auth/register

​
Headers

HeaderValue
Content-Typeapplication/json

​
Body parameters

​
email
string
required
The user’s email address. Must be unique — registration fails if this email is already in use.
​
full_name
string
required
The user’s full name.
​
password
string
required
The user’s password. Must be at least 8 characters.

​
Response

Returns the newly created user object.
​
id
string (UUID)
Unique identifier for the user.
​
email
string
The user’s email address.
​
full_name
string
The user’s full name.
​
is_verified
boolean
Whether the user’s email address has been verified. Defaults to false on registration.
​
is_google_account
boolean
Whether this account was created via Google OAuth.
​
avatar_url
string | null
URL of the user’s avatar image, or null if not set.

​
Example

curl -X POST https://api.pingback.live/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "full_name": "Jane Smith",
    "password": "securepassword123"
  }'

​
Response example

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "email": "jane@example.com",
  "full_name": "Jane Smith",
  "is_verified": false,
  "is_google_account": false,
  "avatar_url": null
}

​
Errors

StatusMeaning
400Email already registered
422Validation error — missing required fields or password too short