Guides
OAuth Integration for Your Site
Integrate CAIRL sign-in, authorization, and consent flows into your site.
OAuth Integration for Your Site
This guide covers the site-side setup and authorization flow at a high level.
Prerequisites
- A CAIRL account with a business facet (
/home/facets/new?type=business) - Registered callback URL(s) on
/home/f/{slug}/connect - Test credentials from
/home/f/{slug}/keys; live credentials once funds are loaded
Authorization Flow
- Redirect the user to the CAIRL authorization endpoint with wire scopes such as
age:18+. - The user authenticates and grants consent.
- CAIRL redirects to your callback with an authorization code.
- Exchange the code for an access token in a server context.
- Use the token to read verified claims from userinfo.
Integration Notes
- Treat callback URL matching as strict.
- Keep token exchange server-side only.
- Handle consent denial and expired sessions gracefully.
Next
- Getting Started — account setup and the five API calls
- Quickstart — complete working code in Node and Python
- Add CAIRL to a base44 app — for no-code sites
- Claims reference — which scopes you can request today