Login

Overview

Authenticates a user with their email and password. On success, returns a JWT Bearer token you can use to authorize subsequent requests.

Request

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

Headers

Header	Value
Content-Type	application/json

Body parameters

string

required

The email address associated with your account.

string

required

Your account password.

Response

string

The JWT Bearer token to include in the Authorization header of authenticated requests.

string

Always "bearer".

Example

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

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

Response example

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

Errors

Status	Meaning
401	Unauthorized — incorrect email or password
422	Validation error — missing required fields

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