Quick Start

Integrate Tabbio OAuth in under 5 minutes. This guide covers everything you need to get started.

Before you begin

  • → Create a Tabbio partner account at /signup
  • → Get your Client ID and Client Secret from the credentials page
  • → Configure your redirect URI in partner settings
1

Register Your Application

Create a partner account and register your application to receive OAuth credentials.

Sign up for partner account

Visit /signup and create your account

Configure redirect URIs

Add your callback URL (e.g., https://yourapp.com/oauth/callback)

Save your credentials

Copy your Client ID and Client Secret (shown only once)

2

Redirect User to Tabbio

When a user clicks "Apply with Tabbio", redirect them to our authorization endpoint.

auth.js
const authUrl = `https://tabbio.com/oauth/authorize?${new URLSearchParams({
  client_id: 'YOUR_CLIENT_ID',
  redirect_uri: 'https://yourapp.com/oauth/callback',
  response_type: 'code',
  scope: 'profile:read'
})}`;


window.location.href = authUrl;

Parameters

client_idYour Client ID from credentials page
redirect_uriMust match exactly what you configured
response_typeAlways set to "code"
scopeAlways "profile:read"
3

Handle the Callback

After user authorization, Tabbio redirects back with an authorization code. Exchange it for an access token.

callback.js
app.get('/oauth/callback', async (req, res) => {
  const { code } = req.query;

  const response = await fetch('https://api.tabbio.com/oauth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_id: 'YOUR_CLIENT_ID',
      client_secret: 'YOUR_CLIENT_SECRET',
      code: code,
      grant_type: 'authorization_code'
    })
  });

  const { access_token } = await response.json();
  req.session.accessToken = access_token;
  res.redirect('/success');
});

Security Note

Never expose your Client Secret in client-side code. This exchange must happen server-side.

4

Fetch User Profile

Use the access token to retrieve the user's profile data from our API.

profile.js
const response = await fetch('https://api.tabbio.com/oauth/profile', {
  headers: { 'Authorization': `Bearer ${accessToken}` }
});

const profile = await response.json();

Testing Your Integration

Test the authorization flow

Click your "Apply with Tabbio" button and verify the redirect works correctly

Verify the callback

Ensure you receive the authorization code in your callback URL

Test token exchange

Successfully exchange the authorization code for an access token

Fetch profile data

Retrieve and validate user profile data with the access token

Monitor in dashboard

Check your partner dashboard to see the authorization events