GitHub
Set up GitHub sign-in with Clowk: create a GitHub OAuth App, set the callback URL, add the client ID and secret, and read the JWT your app gets back.
Overview
Clowk handles the GitHub OAuth 2.0 flow. Users authorize with their GitHub account, and Clowk returns a JWT with their profile information.
Setup
1. Enable GitHub in Clowk
Go to your Clowk dashboard and enable the GitHub provider for your instance.
2. Create a GitHub OAuth App
- Go to GitHub Developer Settings
- Click New OAuth App
- Set the authorization callback URL to:
https://clowk.in/oauth/github/callback - Copy the Client ID and Client Secret into your Clowk dashboard
3. Scopes
Clowk requests these scopes:
| Scope | Purpose |
|---|---|
user:email | Read user email addresses |
read:user | Read user profile data |
OAuth flow
1. Your app → Clowk:
GET https://yourapp.clowk.in/sign-in?redirect_uri=https://yourapp.com/auth/callback
2. Clowk → GitHub:
GET https://github.com/login/oauth/authorize?
client_id=...&
scope=user:email+read:user&
state=...&
redirect_uri=https://clowk.in/oauth/github/callback
3. GitHub → Clowk:
GET https://clowk.in/oauth/github/callback?code=...&state=...
4. Clowk exchanges code for tokens, creates/finds user
5. Clowk → Your app:
GET https://yourapp.com/auth/callback?token=eyJ...JWT payload
{
"iss": "clowk",
"sub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"email": "[email protected]",
"name": "Jane Doe",
"avatar_url": "https://avatars.githubusercontent.com/u/...",
"provider": "github",
"instance_id": "inst_abc123",
"app_id": "app_xyz789",
"iat": 1711152000,
"exp": 1711155600
}GitHub users have email_verified_at set automatically.
Set up Twitter (X) sign-in with Clowk using OAuth 2.0 with PKCE: developer portal setup, callback URL, scopes, and how Clowk handles missing emails.
Apple
Sign in with Apple for Clowk is coming soon. See what the Apple ID integration will do and which providers (Google, GitHub, Twitter, email) work today.