Connecting Kakao Login

To let users of your service sign up with a Kakao account, you first register your service with Kakao and receive a REST API key and a Client Secret.

This page covers the order in which you receive the REST API key and the Client Secret. Putting the two values you received into WEEGLOO is covered in Putting the REST API key and Client Secret into WEEGLOO.

Getting the REST API key and Client Secret from Kakao

Sign in to Kakao, then work through the five steps below in order.

1

Creating an app

If you already have an app you have been using, you can use that app as it is instead of creating a new one. In that case, skip this step and go on to Switching to a Biz app.

  1. Open the applications screen (https://developers.kakao.com/console/app (opens in a new tab)).

  2. Click Create app.

  3. Upload an image in App icon.

  4. In App name, enter the name users will see (for example, Cozy Closet).

  5. In Company name, enter the name of your shop or company. It can be the same as the app name.

  6. In Category, choose the one that fits your service (for example, Lifestyle).

  7. In App primary domain, enter your site's address (for example, https://cozy-closet.com).

  8. Check the operating policy checkbox at the very bottom.

  9. Click Save.

    The Create app modal. An image is uploaded in App icon, App name and Company name hold Cozy Closet, and App primary domain holds the site address

2

Switching to a Biz app

Until you switch to a Biz app, you cannot set email as a required consent item.

If the badge above the app name is already Biz app, skip this step and go on to Turning on Kakao Login.

  1. If the app screen is not open, on the applications screen (https://developers.kakao.com/console/app (opens in a new tab)), click the app you use for login.

  2. Go to App Settings → App → General.

  3. Find the Business information section.

    The Business information section. The Register business information button and the notice that this app is not a Biz app are there, with the Switch to Biz app for an individual button below

What comes next splits depending on whether you have a business registration number. Do only the side that fits your situation.

  1. Click Register business information.
  2. In Business Type, choose Domestic business (Korea). If you are not a domestic business, choose Overseas business (outside Korea).
  3. Enter the Business registration number.
  4. Click Confirm.

The Business information modal. Domestic business (Korea) is selected in Business Type, with the three Business registration number boxes below it

  1. If you have not completed identity verification yet, complete it first. You can get there from the profile area at the top right of the screen, under Account settings → Identity verification.
  2. Come back to this screen and click Switch to Biz app for an individual.
  3. In Purpose, choose To set email to Required consent item.
  4. Click Save.

The Switch to Biz app for an individual modal. Purpose holds To set email to Required consent item

If you have never agreed to the Kakao Business consolidated Terms of Service, a terms agreement screen opens after you click Save. Once you agree, the switch carries on.

Either way, when the switch is finished, the badge above the app name changes to Biz app.

3

Turning on Kakao Login

  1. If the app screen is not open, on the applications screen (https://developers.kakao.com/console/app (opens in a new tab)), click the app you use for login.

  2. Go to Product Settings → Kakao Login → General.

  3. Turn on the State toggle in Usage settings.

  4. In the confirmation dialog, click Activate.

    The Product Settings → Kakao Login → General screen. The State toggle under Usage settings is on, with the OpenID Connect toggle below it

When you turn the toggle on, an OpenID Connect toggle appears below it. Leave that toggle as it is.

4

Setting the consent items

On Kakao Login's Consent Items screen, you have to change all three items, Email, Nickname, and Profile image, to Required consent. If you leave even one of them as it is, users are blocked on a Kakao error screen before they can even start logging in.

  1. Go to Product Settings → Kakao Login → Consent Items.

  2. In the Personal information table, click Set on the Email row.

  3. Choose Required consent.

  4. In Purpose of consent, enter Member identification.

  5. Click Save.

    The consent item setting modal. Required consent is selected for Email, and Purpose of consent holds Member identification

  6. Change Nickname the same way, starting from step 2. Its Purpose of consent is Display member name.

  7. Change Profile image the same way, starting from step 2. Its Purpose of consent is Display member profile.

  8. Check that the State of all three items is Required consent.

    The Personal information table on the Consent Items screen. The State of Nickname, Profile image, and Email is Required consent, and the remaining items are Unauthorized

5

Copying the REST API key and the Client Secret

  1. Go to App Settings → App → Platform Key.

    The App Settings → App → Platform Key screen. The REST API key, JavaScript key, and Native app key cards sit side by side

  2. Click the REST API key card. Three kinds of key appear, and this is the one you use.

    The Edit REST API key screen. The REST API key value is at the top, the Kakao Login Redirect URI box is empty below it, and further down are the Kakao Login row and the Business Authentication row of Client Secret

  3. In the Kakao Login Redirect URI box, paste the address below. Pick your Space and the identifier is filled in.

    Space
    https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/kakao

    If you are not sure which Space is yours and you have handed the integration to an AI agent, you can also ask the agent. Ask in the chat, "Tell me the Redirect URI to register with Kakao Login", and you receive the finished address.

  4. Copy the REST API key value at the top.

  5. Copy the Code on the Kakao Login row of Client Secret. It is not the code on the Business Authentication row below it.

  6. Click Save.

The secret is a secret value. Do not tell it to anyone, and do not write it down anywhere public.

Putting the REST API key and Client Secret into WEEGLOO

Now you have the REST API key and the Client Secret in hand. Here is which box in the content studio each of the two values goes into.

Kakao screenContent studio
REST API keyREST API key
The Kakao Login code of Client SecretClient Secret - Kakao Login Code

From here the path splits depending on how you have been working so far.

If you were configuring this directly in the content studio, follow these steps.

  1. Go back to turning on social login in Service Member Login.
  2. Turn on Kakao.
  3. Enter the REST API key in the REST API key box in Step 2.
  4. Enter the Kakao Login code of the Client Secret in the Client Secret - Kakao Login Code box.
  5. Click Save.

If you handed the integration to an AI agent and were told to go and get the REST API key and the Client Secret, paste the two values you received into the chat as they are and carry on with what you were doing. The agent handles the rest of the configuration from there.

What to do next

  • Service Member Login: put the values you received into the content studio and finish the rest of the member login configuration.
  • Member Roles and Permissions: create the ServiceUserRole that decides what a signed-up member can see and use.
  • Auth API: covers technical specifications such as the request format you need when wiring login into your own site's code.