Misar IO Docs
Getting Started

Quickstart

Start authenticating with Misar ID in minutes.

Quickstart

Integrate Misar authentication into your application.

Prerequisites

A Misar account — sign up at misar.io
An application registered in the Misar Developer Console

Step 1: Get Your Credentials

After registering your app, you'll receive:

  • Client ID — public identifier for your app
  • Client Secret — keep this server-side only

Step 2: Redirect to Login

Send users to the Misar ID login page:

https://id.misar.io/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://yourapp.com/callback&
  response_type=code&
  scope=openid profile email

Step 3: Exchange the Code

After login, exchange the authorization code for tokens:

curl -X POST https://id.misar.io/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": "AUTH_CODE",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uri": "https://yourapp.com/callback"
  }'

Step 4: Use the Token

Include the access token in API requests:

curl https://id.misar.io/userinfo \
  -H "Authorization: Bearer ACCESS_TOKEN"
For same-domain Misar apps (*.misar.io), the session cookie is automatically shared — no token exchange needed.