Skip to main content

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. Use the app’s REST API key as the client ID and the Kakao Login client secret as the client secret:
2

Configure

lib/theauth.ts

Scopes

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

How it works

  • Scopes are sent comma separated, as Kakao requires.
  • Kakao’s REST guide does not describe PKCE, so no code challenge is sent.
  • The client secret is required at the token endpoint unless you turn it off for the app in the Kakao console.
  • The profile call is https://kapi.kakao.com/v2/user/me. The numeric id is stored as a string, and the email, nickname and image sit under kakao_account.
  • The email counts as verified only when both is_email_verified is true and is_email_valid is not false.
  • A refresh returns a new refresh token only when the old one expires within a month.
kakaoProvider (the older preset) reads only the OIDC sub claim and cannot read Kakao’s profile shape. It is still exported for existing code. Use createKakaoProvider for new setups.
Vendor docs: Kakao Login REST API.

Endpoints

Last modified on October 18, 2026