Kakao Connect

You can use either Kakao Login or Kakao Sync as a social login provider for ReachFive. Both options allow your users to sign in with their Kakao account, but Kakao Sync offers additional user information, consent synchronization, and a simplified sign-up experience.

To integrate either option, you need an App ID and App Secret from your Kakao app, which you’ll configure in your ReachFive settings.

This page details:

  • The difference between Kakao Login and Kakao Sync

  • The user information retrieved from Kakao

  • How to connect Kakao with your ReachFive account

Kakao Login vs Kakao Sync

Kakao provides two types of integrations that use the same login API but differ in data access, consent flow, and business requirements.

The availability of each field may depend on granted scopes, business review status, and user consent. For full up-to-date details, refer to link:Kakao’s Developer documentation.
User information / Feature Kakao Login Kakao Sync

KakaoTalk ID

✅

✅

KakaoTalk name, nickname, username

✅

✅

Profile image

✅

✅

Email

✅

✅

Birthday

⚙️ Optional (requires user consent)

✅

Gender

⚙️ Optional (requires user consent)

✅

Phone number

⚙️ Optional (requires user consent)

✅

Verified phone number (phone_number_verified)

⚙️ Requires OpenID Connect Activation

✅ Included by default

Address

❌

✅ Requires Kakao Sync and address custom fields in ReachFive

Connecting Information (CI)

❌

✅ Included in provider_metadata

Age range (kakaotalk_age_range)

⚙️ Optional

✅

User consents

✅ (manual mapping required)

✅ (automatically synced via Simple Signup)

KakaoTalk Channel auto-follow

❌

✅

One-click signup (Simple Signup)

❌

✅

Requires Kakao Business registration and Sync review

❌

✅

  • If you only need basic authentication and profile data, Kakao Login is sufficient.

  • If you want richer verified user information (such as CI or address), auto-synced consents, and one-click sign-up, you must use Kakao Sync.

Implementation details

Phone number verification

To retrieve the phone_number_verified field with Kakao Login, you must enable OpenID Connect Activation in your Kakao application.

Address fields (Kakao Sync only)

If you collect address information through Kakao Sync, ensure that the following address custom fields exist in your Addresses object:

Otherwise, address information will not be imported.

Example
{
  "path": "kakaotalk_address_id",
  "scope": ["string"],
  "name": "kakaotalk_address_id",
  "data_type": "string",
  "id": "kakaotalk_address_id"
}
See the Kakao API reference for details on the shipping_address object format.

Provider metadata

Kakao Sync enriches the provider_metadata object with:

  • Connecting Information (CI)

  • Age range (kakaotalk_age_range)

  • Verification timestamps

See provider_metadata for details.

User consents

You can import user consents from Kakao into ReachFive through the Kakao REST API.

To ensure proper consent synchronization:

  • Assign opt-in type to corresponding ReachFive consents.

  • Match each consent’s key with the Kakao consent tag.

When configured correctly, consents are imported when a user logs in via Kakao for the first time.

At time of writing, consents in Kakao are found under Product Settings  Kakao Login  Simple Signup and include:

  • Terms of Service

  • Consent for age 14 and over

Connect Kakao with ReachFive

Follow these steps to connect your Kakao app with your ReachFive account.

  1. Go to Kakao Developers and log in.

  2. Create a new application or open your existing Kakao app.

  3. Register a Web platform and add your site domain.

    https://<REACHFIVE_DOMAIN> (1)
    1 Where <REACHFIVE_DOMAIN> is your domain.

  4. Activate Kakao Login.

  5. Set your redirect URI:

    https://<REACHFIVE_DOMAIN>/login/callback (1)
    1 Where <REACHFIVE_DOMAIN> is your domain.

  6. Set consent states under Product Settings  Kakao Login  Consent items. Choose one of the following for each scope:

    • Required consent: Users must consent to complete login.

    • Optional consent: Login completes without user consent.

  7. If using Kakao Sync, enable Simple Signup and complete the Kakao review process before production. See Kakao Sync review.

  8. After configuration, connect the app to ReachFive:

    1. Retrieve your REST API key and Admin key from the Kakao App Keys section.

      Kakao {company}

      REST API key

      Client ID

      Admin key

      Client secret

      kakao keys

    2. In the ReachFive Console, go to Settings  Providers  KakaoTalk.

    3. Paste the REST API key into the Client ID field.

    4. Paste the Admin key into the Client secret field.

    5. Don’t forget to Save your input.

      kakao reachfive console

Resources

For more information, see Kakao’s official documentation: