Register

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

Header	Value
Content-Type	application/json

Body parameters

string

required

The user’s email address. Must be unique — registration fails if this email is already in use.

string

required

The user’s full name.

string

required

The user’s password. Must be at least 8 characters.

Response

Returns the newly created user object.

string (UUID)

Unique identifier for the user.

string

The user’s email address.

string

The user’s full name.

boolean

Whether the user’s email address has been verified. Defaults to false on registration.

boolean

Whether this account was created via Google OAuth.

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"
  }'

const response = await fetch('https://api.pingback.live/api/v1/auth/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'jane@example.com',
    full_name: 'Jane Smith',
    password: 'securepassword123',
  }),
});
const data = await response.json();

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

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

Authentication

Conversations

Channels & Widget

Team

Knowledge Base

Analytics

Overview

Request

Headers

Body parameters

Response

Example

Response example

Errors

​Overview

​Request

​Headers

​Body parameters

​Response

​Example

​Response example

​Errors

Overview

Request

Headers

Body parameters

Response

Example

Response example

Errors