> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coloop.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OAuth Application Setup

To integrate with CoLoop, you'll need to provide us with the following information:

1. **Application Name**: A name to identify your integration (e.g., "Your Product Name")
2. **Callback URL**: The URL where users will be redirected after authenticating with CoLoop (e.g., `https://yourdomain.com/oauth2/callback`)
3. **Application Type**: Whether your application is public or private
   * Choose **private** for server-side applications that can securely store credentials
   * Choose **public** for client-side applications (browsers, mobile apps) that require PKCE flow

Once you provide this information, we'll create an OAuth application for you and provide you with the necessary credentials and endpoints.

### Response Format

For private applications, you'll receive the following configuration:

```json theme={null}
{
  "object": "oauth_application",
  "id": "oa_xxx",
  "instance_id": "ins_xxx",
  "name": "Your App Name",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "public": false,
  "scopes": "email profile",
  "callback_url": "https://your-domain.com/oauth2/callback",
  "authorize_url": "https://clerk.coloop.ai/oauth/authorize",
  "token_fetch_url": "https://clerk.coloop.ai/oauth/token",
  "user_info_url": "https://clerk.coloop.ai/oauth/userinfo",
  "discovery_url": "https://clerk.coloop.ai/.well-known/openid-configuration",
  "created_at": 1234567890123,
  "updated_at": 1234567890123
}
```

For public applications, the configuration will be similar but without the `client_secret` field and `public` set to `true`:

```json theme={null}
{
  "object": "oauth_application",
  "id": "oa_xxx",
  "instance_id": "ins_xxx",
  "name": "Your App Name",
  "client_id": "your_client_id",
  "public": true,
  "scopes": "email profile",
  "callback_url": "https://your-domain.com/oauth2/callback",
  "authorize_url": "https://clerk.coloop.ai/oauth/authorize",
  "token_fetch_url": "https://clerk.coloop.ai/oauth/token",
  "user_info_url": "https://clerk.coloop.ai/oauth/userinfo",
  "discovery_url": "https://clerk.coloop.ai/.well-known/openid-configuration",
  "created_at": 1234567890123,
  "updated_at": 1234567890123
}
```

### Important Security Notes

1. For private applications, store the `client_secret` securely as it cannot be retrieved later
2. Public applications use PKCE flow and don't receive a client secret
3. The provided scopes (`email profile`) allow access to basic user information

Contact the CoLoop team to set up your OAuth application during the Alpha phase. In future releases, this process will be self-serve through our developer portal.