Set Up a Wristband Application

Applications are the start of everything when setting up Wristband.

The first thing you'll need to do to start using Wristband is create an application. An application in Wristband represents the actual application you are building. All other entities that you create, such as tenants, users, and clients, will be within the context of an application.


Prerequisite: Create a Wristband Account

If you don't already have an account with Wristband, please follow the below instructions to complete the sign-up process.

  1. Visit the Wristband sign-up page.
  2. Fill in the required information on the sign-up form.
  3. Verify your email address by entering the one-time passcode sent to your signup email.

Create a New Application

When you log in to Wristband, you'll land on the Dashboard Home Page. To create an application, do the following:

  1. Click the "Add Application" button.
Wristband Dashboard Home Page

Provide Required Application Fields

Clicking the "Add Application" button will open a modal asking for the following information:

  1. Display Name: This will be the name that the UI will use when referring to your application.
  2. Domain Name: Each application within your Wristband tenant must have a unique (case-insensitive) domain name. The domain name will be used to construct the application's vanity domain. Note: The domain name is immutable and can't be changed after the application is created.
  3. Enable Production Environment Validations: When an application is created, you can specify whether production validations should be enabled or not. When production validations are enabled, Wristband will enforce stricter validations on entity fields in order to prevent insecure configurations. For example, with production validations enabled, client redirect URLs must use the https scheme; whereas when production validations are disabled, the http scheme is allowed to make it easier for developers to test on their local machines. Note: The validation setting is immutable and can't be changed after the application is created.
Create Application Modal in Wristband

Specify The Application Login URL

After clicking the "Next" button, you'll be presented with a screen asking for the following information:

  1. Application Login URL: The login URL is the endpoint within your application that redirects to the Wristband Authorize endpoint. If you're creating an application for local testing, then the URL might look like: http://localhost:3001/login; however, if you're creating a production application, the URL will need to use the https scheme and can't point to localhost. An example of a valid production login URL is: https://yourapp.com/login.
Step 2 - provide application login URL

Finalize Application Setup

Once you have completed the above steps, you will reach a confirmation screen showing all the details you have provided.

Step 2 - provide application login URL

If you are satisfied with the configuration, click the "Create" button.

Success! You've created your first app.


Copy The Application Vanity Domain

If you aren't already within the Application View, select the application from the Dashboard Home Page that you just created. This will take you to the Application Settings page. On the Application Settings page, you will see details regarding your application, including the "Application Vanity Domain". Copy this value as it will be needed when you configure the Wristband Auth SDK later in the quick start.


What’s Next

After creating your application, you will need to create an OAuth2 Client to establish communication between your app and Wristband.