Authaz logoAuthaz
DocumentationAPI Reference
  • Get Started

    • Authaz
    • Core Concepts
    • Set up your app
    • Quickstart — cURL
  • Authentication

    • Authentication Settings
    • Signup
    • Invitations
    • Password Authentication
    • Multi-Factor Auth
    • Magic Link
    • OAuth / Social Login
    • Passkey (WebAuthn)
    • SAML SSO
    • Machine-to-Machine (M2M)
    • API Keys
  • Authorization

    • Authorization
    • Resources
    • Policies
    • Roles
    • Access Explorer
  • Tenancy

    • Multi-tenancy
    • Tenancy Customization
  • Brand & Host

    • Branding
    • Custom Domains
    • Communications & Email Templates
  • Operate

    • Users
    • Analytics
    • Audit Logs
    • Application Settings
  • SDK Quickstarts

    • Quickstart — Next.js
    • Quickstart — React SPA
    • Quickstart — Hono
    • Quickstart — .NET (Authaz.Sdk)
  • Recipes

    • Recipes & Cookbook
    • Next.js — first integration
    • Next.js — B2B SaaS (multi-tenant)
    • Hono — first integration
    • Hono — B2B SaaS (multi-tenant)
    • React SPA — first integration
    • React SPA — B2B SaaS (multi-tenant)
    • .NET — first integration
    • .NET — B2B SaaS (multi-tenant)
  • Reference

    • Tokens
    • API Reference
    • Errors & Troubleshooting
  • Documentation

    • How Authaz is Built
  1. Authaz
  2. Docs
  3. Get Started
  4. Set up your app

Get Started

Set up your app

2 min read·Updated Jun 19, 2026

Every quickstart needs the same three values from the Authaz dashboard and one redirect URI registered. Do this once, then come back to your quickstart.

About 60 seconds.

1. Create an organization and application#

  1. Sign up at dashboard.authaz.io. The signup creates your Organization automatically.
  2. Click New application, name it, and create. The dashboard generates an Application ID, Client Secret, and Domain for you.

2. Copy these three values#

From the application's Settings → API Keys tab:

Dashboard labelFormatUse as
Application IDapp_01h...
Previous
Core Concepts
Next
Quickstart — cURL
AUTHAZ_CLIENT_ID
Client Secretsecret_...AUTHAZ_CLIENT_SECRET
Organization ID0199...AUTHAZ_ORGANIZATION_ID

Two optional values, depending on the quickstart:

Dashboard labelFormatUse asNeeded for
Tenant ID0198...AUTHAZ_TENANT_IDMulti-tenant apps
Management API Keymgmt_01h...AUTHAZ__APIKEYThe .NET / Management quickstart

3. Register your redirect URI#

Authaz only redirects users back to URLs you explicitly allow.

In Settings → Redirect URIs, add:

http://localhost:3000/auth/callback

The cURL quickstart uses http://localhost:3000/callback instead. Add both if you plan to follow both. Add your production URL too once you have one.

The #1 onboarding bug. If the URL you register doesn't match the one your code sends, Authaz returns invalid_request and the user lands on an error page. Trailing slashes count. Ports count. http vs https counts.

4. Drop the values into your quickstart#

A starter .env covering every variable any quickstart uses:

AUTHAZ_CLIENT_ID=app_01h...
AUTHAZ_CLIENT_SECRET=secret_...
AUTHAZ_ORGANIZATION_ID=0199...
 
# Optional — multi-tenant only
AUTHAZ_TENANT_ID=0198...
 
# Optional — Management API (e.g. the .NET quickstart)
AUTHAZ__APIKEY=mgmt_01h...

Done. Pick your quickstart:

  • cURL — OAuth 2.0 + PKCE end-to-end, any language.
  • Next.js — App Router with @authaz/next.
  • React — SPA with @authaz/react.
  • Hono — Backend with @authaz/hono.
  • .NET — Management API with Authaz.Sdk.

Or jump to a complete worked example in the Recipes & Cookbook.