Skip to main content

Create Application

An application is an isolated tenant in YorAuth. Each application has its own set of users, roles, permissions, and API credentials. You will typically create one application per project or per environment (development, staging, production).

Create from the Dashboard

  1. Log in at app.yorauth.com
  2. Click New Application from the dashboard home or the Applications sidebar item
  3. Fill in the form:
FieldRequiredNotes
NameYesA human-readable label, e.g. "My App - Production"
EnvironmentNodevelopment, staging, or production. Defaults to development
DescriptionNoOptional notes for your team
  1. Click Create Application

The application is created immediately.

Credentials You Receive

After creation, navigate to the application's API Keys page to generate your first API key.

You will work with two identifiers:

Application ID

A UUID that identifies your application in every API request. It appears in the URL of every page in the dashboard for that application. It looks like:

text
app_01234567-89ab-cdef-0123-456789abcdef

API Key

A secret key used to authenticate server-side API calls. It is shown once at creation time — copy it immediately and store it in your environment variables.

text
sk_live_...

API keys are shown only once. If you lose a key, revoke it and generate a new one from the API Keys page.

Environments

Applications have an environment value (development, staging, or production). Development applications also support test mode, which allows you to seed users and reset data using the test API endpoints — useful during integration.

Next Steps

With your application ID and API key in hand, you are ready to make your first API call.