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:Scopes
Default scopes:account_email, profile_nickname, profile_image
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 numericidis stored as a string, and the email, nickname and image sit underkakao_account. - The email counts as verified only when both
is_email_verifiedis true andis_email_validis 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.