Authenticate (v2)

​

Purpose

​

HTTP Request

POST https://integrations.clopos.com/open-api/v2/auth

​

Where the credentials come from

• integrator_id — issued by Clopos. Every v2 integration must send one. Request it by filling out this form: https://forms.gle/Y9P1Wnv4QFAruxny8
• client_id, client_secret, brand — come from the Clopos customer you are integrating with. They generate the Client ID and Client Secret themselves in their back office under Add-ons → Open API, then share both values and their brand identifier with you.

​

Request Example

curl --location 'https://integrations.clopos.com/open-api/v2/auth' \
  --header 'Content-Type: application/json' \
  --data '{
    "client_id": "your_client_id_here",
    "client_secret": "your_client_secret_here",
    "brand": "your_brand",
    "integrator_id": "your_integrator_id_here"
  }'

​

Request body

​

Response

​

200 OK — Token issued

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbiI6Im9hdXRoX1lOellQZE1QV21KeU0zOFVyblQzR3hoS25TelBNTHl2clB2UGgxQnRaeVFScTVzRWJsRkl5b3MwYVIyejMwWmYiLCJicmFuZCI6Im9tZWdhIiwic3RhZ2UiOiJiZXRhIiwidmVudWVfaWQiOjEsImludGVncmF0b3JfaWQiOiJ0ZXN0X2pLc1U5NnJxMzMzYjZQb3RUWmZrZ3ciLCJpYXQiOjE3Njc4NDg3MzIsImV4cCI6MTc2Nzg1MjMzMn0.7atyo3LEPXTyIjs2BjZIcUbWeFYtr375GeDwoVnWSRs",
  "token_type": "Bearer",
  "expires_in": 3600,
  "expires_at": 1767852332,
  "message": "Authentication successful"
}

​

How to use the token

• Include only the x-token header on all other v2 endpoints:
  x-token: <your JWT here>
  
• Tokens expire after expires_in seconds; expires_at indicates the epoch timestamp when the token becomes invalid.

​

Integrator ID