Back to Docs

Integration Participants

Choose your integration type and follow the appropriate process

Mini-App Integration

Hub Family Applications - Trusted services that are part of the RegardingWork ecosystem network and need seamless user authentication.

  • RegardingWork services & trusted partners
  • Uses SSO (Single Sign-On)
  • Direct token exchange
  • Simplified integration
Mini-App Guide
Third-Party Integration

External Applications - Non-internal apps or external clients who want to connect to Hub API with proper authorization flows.

  • External client applications
  • Uses OAuth 2.0 protocol
  • Authorization code flow
  • Secure & standardized
Third-Party Guide
Which Integration Type Should I Use?
Question Mini-App (SSO) Third-Party (OAuth)
Is this part of RegardingWork network? Yes (trusted ecosystem) No (external client)
Domain relationship RegardingWork or trusted partner External/independent domain
Integration complexity Simple Standard OAuth
User experience Seamless Authorization prompt
Security model Trust-based OAuth 2.0 standard
Common Error Patterns
400 - Bad Request

Common Cause: Domain not in SSO allowed list

Error: "Invalid redirect_uri domain"

Fix: Add domain via admin panel

401 - Unauthorized

Common Cause: Token validation issues

Error: "Invalid token"

Fix: Check token format and validation endpoint

500 - Server Error

Common Cause: Configuration issues

Error: Database or environment problems

Fix: Check server logs and configuration

Quick Start

New to integrations? Start with the SSO vs OAuth explanation to understand the fundamental differences, then choose your participant type above.