Skip to main content

OAuth Protection

OAuth protection requires Solo plan or higher. See Plans for details.
OAuth protection adds a sign-in step before users can access sensitive features in your app. When enabled, users are prompted to connect their account before protected tools or data become available.

When to Enable OAuth

Turn on OAuth when your app:
  • Reads or writes user-specific data (account details, order history, personal settings).
  • Performs actions that must be tied to a specific user identity.
  • Accesses protected resources that require an access token from a third-party service.
If your app only displays public information or uses app-level API keys, you do not need OAuth.

What the User Sees

When a user opens an OAuth-protected app in ChatGPT, here is what happens:
  1. The user opens the app and starts a conversation.
  2. When they trigger a protected feature, ChatGPT prompts them to connect or sign in to the required service.
  3. The user completes sign-in in a pop-up window.
  4. They return to the conversation with protected features unlocked.
ChatGPT showing an OAuth connect prompt

The OAuth sign-in prompt as seen by the user in ChatGPT

The sign-in flow is handled entirely by ChatGPT. You do not need to build a login UI.

Enable OAuth on Your App

1

Open the Connect tab

In the builder, open the Connect tab in the left panel.
Connect tab in the builder

The Connect tab in the builder

2

Enable OAuth protection

Toggle OAuth Protection on. Chippy handles the OAuth flow. You do not need to configure a provider, set up redirect URIs, or manage tokens yourself.
OAuth protection toggle in the Connect tab

Enabling OAuth protection

3

Test the sign-in flow

Open the preview panel and trigger a protected feature to verify the sign-in prompt appears correctly (see the testing section below).

Design Guidance

Not every feature in your app needs to be behind OAuth. A good pattern is to keep low-friction features open and gate only the sensitive ones. Open features (no sign-in required):
  • General information lookups
  • Public data searches
  • Help and FAQ tools
Protected features (sign-in required):
  • Viewing account details
  • Placing orders or making changes
  • Accessing billing or payment data
This approach reduces friction for casual users while protecting actions that require identity verification.

Testing OAuth in Preview

1

Open the preview panel

Open your app’s preview in the builder.
2

Trigger a protected feature

Type a prompt that invokes a tool requiring OAuth (e.g., “Show my account details”).
3

Complete the sign-in flow

The preview will show the OAuth prompt. Complete sign-in with a test account.
Preview panel showing the OAuth sign-in prompt

OAuth prompt appearing in preview

4

Verify access

After signing in, confirm the protected tool returns real user-specific data. Check Traces to verify the access token was used correctly.
Use a test account or sandbox environment for OAuth testing. Avoid using production credentials during development.

Troubleshooting

What’s Next

API Integrations

Connect tools to the services your OAuth tokens authorize.

Secrets

Store client secrets and other credentials securely.