One Connect Integration Guide

You are adding One Connect to this application. Its users will grant the app scoped, revocable access to their own One-connected tools (Gmail, Stripe, Notion, ...) through standard OAuth 2.1 (authorization code + PKCE).

What you build is small:

Frontend                Your backend                          One
--------                ------------                          ---
<ConnectButton>  ---->  GET /api/one/authorize  ----302---->  api.withone.ai/oauth/authorize
                                                              -> hosted page on connect.withone.ai
                                                                 (sign-in code, pick tools, consent)
                        GET /api/one/callback   <---302-----  ?code=...&state=...
                          exchanges code -> tokens (server-to-server)
                          stores tokens, redirects to /?one_connect=success
                                                  <---------- SDK fires onSuccess