Kakao signs users in with their Kakao account, the default consumer identity in South Korea, alongside NAVER.

## Copy the redirect URI

In the [Authdog console](https://console.authdog.com), select the project and environment, open **Authentication > Providers**, find **Kakao**, and click **Enable**. Copy the redirect URI shown in the form:

```url
https://identity.authdog.com/api/v1/callback/<connectionId>
```

## Create the application

1. Open [Kakao Developers](https://developers.kakao.com/console/app) and create an application.
2. Under **App Keys**, note the **REST API key**: that is the client ID.
3. Enable **Kakao Login** and add the redirect URI from Authdog under **Redirect URI**.
4. Under **Consent Items**, enable the profile and email items. Email requires business verification.
5. Under **Security**, generate a **Client Secret** and set it to *enabled*.

## Configure Authdog

| Field | Value |
| --- | --- |
| **Client ID** | The Kakao **REST API key** |
| **Client Secret** | The generated **Client Secret**, with its status set to enabled |

Save, then toggle the connection **active**.

## What Kakao returns

Authdog requests the `profile account_email` scopes and reads the profile from `https://kapi.kakao.com/v2/user/me`.

The user endpoint returns the Kakao id, nickname, profile image, and (when the consent item is approved) the account email with its verified flag.

Email is an optional consent item. Until Kakao approves it for your app, expect users with no email address.

## Test it

1. Open your environment's hosted sign-in page, or link to `https://identity.authdog.com/api/v1/signin/<connectionId>`.
2. Select the Kakao button and complete the flow.
3. Confirm the user appears under **Users** in the console with a Kakao identity linked.

## Troubleshooting

| Symptom | Cause |
| --- | --- |
| `KOE006` invalid redirect | The redirect URI is not registered on the app |
| `KOE101` invalid client | The client secret is generated but not enabled |
| No email in the profile | The email consent item is not approved for this app |
| Redirect or callback URL error | The URI registered with the provider does not match Authdog's exactly |
| Works in one environment only | Each environment has its own `connectionId`, and so its own redirect URI to register |

## Related

| Read | To learn how to |
| --- | --- |
| [Connectors](/docs/connectors) | Set up any other social provider |
| [NAVER](/docs/connectors/naver) | Add the other major Korean consumer identity |