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 |