Skip to main content
Yoyo Hosted Auth

Yoyo Authorisation Documentation

A single hosted login for every Yoyo experience. Redirect users to the auth portal, launch them into their destination, and consume sessions safely.

Start With The DocsView API Reference
🤖 AI Agent

Building an integration? Start with our complete LLM integration guide — a single-file reference with all environments, URLs, methods, constraints, and examples.

SSR Quickstart Next.jsSPA Quickstart React ViteMobile Quickstart Webview Or BrowserLocal Development Quickstart

Authentication Flow

Follow the hosted flow to establish a shared session across Yoyo subdomains.

Step 1

Redirect To Hosted Auth

Send users to auth.yoyogroup.com (prod) or auth-int.yoyogroup.com (int) with a redirectUrl back to your app.

Step 2

Authenticate And Set Cookies

The hosted portal establishes HttpOnly cookies for .yoyogroup.com.

Step 3

Consume The Session

Read cookies server-side and expose only a minimal BFF session shape.

Quick Links

Jump directly to the most common integration paths.

Handle Redirects And Allowlists

Implement safe hosted-auth and OAuth redirect handling.

Explore

Add Your App To Launch Pad

Get listed on the Launch Pad so users can jump into your app after login.

Explore

Work With Shared Cookies

Read the session securely on the server and forward tokens to APIs.

Explore

API Reference

Review the public logout endpoint used to clear shared cookies.

Explore

Complete Integration Reference

Single-file reference for AI agents with all environments, URLs, methods, constraints, and examples.

Explore

Coming Soon Authentication Types

Additional enterprise options will be added to the hosted portal.

SAMLSSO

Contact Us

Need access, allowlisting, or Launch Pad updates? Email support.sa@yoyogroup.com.