Kakao - KavachOS

Setup

1

Get credentials

Go to the Kakao Developers portal and create an application. Under Kakao Login, enable the feature and add your redirect URI:

https://your-app.com/api/kavach/auth/oauth/callback/kakao

2

Configure

lib/kavach.ts

import { createKavach } from 'kavachos';
import { oauth } from 'kavachos/auth';

const kavach = await createKavach({
  database: { provider: 'sqlite', url: 'kavach.db' },
  plugins: [
    oauth({
      providers: [
        {
          id: 'kakao',
          clientId: process.env.KAKAO_CLIENT_ID!,
          clientSecret: process.env.KAKAO_CLIENT_SECRET!,
        },
      ],
    }),
  ],
});

KAKAO_CLIENT_ID=...
KAKAO_CLIENT_SECRET=...

Scopes

Default scopes: profile_nickname, account_email

Scope	What it unlocks
`profile_nickname`	Kakao nickname
`profile_image`	Profile image
`account_email`	Email address (requires business verification)

Email access requires business verification in the Kakao Developer Console. Without it, only profile_nickname and profile_image are available.

Endpoints

Method	Path	Description
GET	`/auth/oauth/authorize/kakao`	Redirect to Kakao
GET	`/auth/oauth/callback/kakao`	Handle callback

Last modified on April 29, 2026