---
updatedAt: 2026-07-31T08:22:22.000Z
agentTools:
projectIndex: https://docs.wristband.dev/llms.txt
---
# Set Up a Wristband Application
Start your Wristband integration by creating an application in the dashboard. You'll use this application to configure authentication and manage your users and tenants.
## Key aspects of Wristband applications
* **Environment separation:** Wristband supports environment isolation by using separate applications for QA, staging, and production. Each application maintains its own configuration, allowing production-level validation policies to be enabled or disabled independently for each environment.
* **Hierarchy:** All subordinate entities, including tenants, users, and OAuth2 clients, are scoped to a specific application.
* **Domain assignment:** Each application is assigned a unique vanity domain that is used to access its login and signup flows.
## Create a New Application
To create an application, log in to the Dashboard and perform the following steps:
1. Select **Add Application**.
2. Select Quickstart > **Continue**.
3. Select your framework > **Continue**
4. Enter your application name > **Continue**.
5. Review the summary > **Create**.
6. Following provisioning, copy the displayed environment variables. These values are required to initialize the SDK instance.
Click **Done** to exit, or click the framework link to view integration steps.
## Manually Retrieving SDK Configuration Values
Upon reaching the final screen of the Add Quickstart Application modal, three environment variables necessary for Wristband SDK configuration are displayed.
* `WRISTBAND_APPLICATION_VANITY_DOMAIN`
* `WRISTBAND_CLIENT_ID`
* `WRISTBAND_CLIENT_SECRET`
If these configuration parameters are lost, use the following steps to recover them:
* ### `WRISTBAND_APPLICATION_VANITY_DOMAIN`
* **Navigate:** Go to Dashboard Home and click your application.
* **Locate:** Open Settings and copy the value from the Application Vanity Domain field.
* ### `WRISTBAND_CLIENT_ID`
* **Navigate:** Dashboard Home -> Your App -> OAuth2 Clients (left menu).
* **Locate: **Select the relevant client to view its Client ID in the top section.
* ### `WRISTBAND_CLIENT_SECRET`
Client secrets are only displayed once after creation. If lost, generate a new one via rotation:
1. **Navigate:** OAuth2 Clients > Select your client.
2. **Locate:** Go to Edit Client > Scroll to Client Secret Settings.
3. **Action:** Click Rotate and copy the new secret from the pop-up modal.
{`
`}