Setting up your Wristband account

Welcome to Wristband! Follow this guide to quickly set up your Wristband account and get started with our powerful authentication platform.

Step 1: Create Your Wristband Account

1. Visit the Wristband sign-up page.
2. Fill in the required information and complete the sign-up process.
3. Verify your email address by clicking on the verification link sent to your inbox.

Step 2: Dashboard Overview

Upon your initial login to Wristband, you'll arrive at the home page. The primary goal at this stage is to create applications, whether it's a demo app as you acquaint yourself with the Wristband dashboard or if you're configuring your fifth application.

📘

Adding Demo Apps

If you are new to Wristband, it is highly recommended to start with the Setting Up a Demo App tutorial. Creating a demo app on your local machine is one of the fastest ways to familiarize yourself with our platform. Simply click the "Add Demo App" button to navigate through the walkthrough for provisioning a Wristband demo app.

Creating New Applications

The main section of the dashboard features prominent tile buttons that serve as gateways to the configuration menus for your application resources. Upon your initial entry into the Wristband dashboard, your account will display no applications. To create a new application from the ground up, distinct from any demo application, click on the prominent "Add Application" tile button. This will guide you through a walkthrough for provisioning your own application.

Step 3: Create Application Modal

Upon clicking the "Add Application" button, a modal will open with a walkthrough on creating an application. The first screen will ask you for two fields: an application display name and an application domain name.

Immutable Fields

Certain fields within an application entity are immutable after the application is created in Wristband. Any form fields deemed immutable will be marked with a warning symbol for your awareness.

The display name is a friendly name given to the application for display purposes. The domain name is the immutable value that will be used when constructing the Wristband vanity domain for the application. Application domain names must be unique (case-insensitive) within your Wristband account. Validations for the domain name field include:

• Minimum character length: 3 characters
• Maximum character length: 20 characters
• Format: Lowercase alphanumeric characters only; special characters are not allowed.

Production environment validations ensure that all URLs registered in Wristband must use HTTPS and prohibit the use of "localhost" domains. If you are conducting tests in a local development or non-staging QA environment, you can leave this validation disabled. However, it is highly advised to enable this setting for production environments.

HTTPS Production Requirement

It is imperative that your application enables production validations upon deployment. Leaving this setting disabled in the production environment implies assuming the risk associated with keeping it turned off.

Finally, configure the login URL for your application.

The application Login URL is the specific URL you implement in your own application's code. It is used to redirect to the Wristband Authorize Endpoint. This URL is crucial during the login flow, signup, and user invitation processes.

To enable subdomains for each tenant under the same application, use the {tenant_domain} token as a domain prefix in your login URL. Refer to the Tenant Domain Token documentation for more details.

M2M Only Applications

If you are developing an application exclusively designed to utilize Machine-to-Machine (M2M) OAuth2 Clients, you can use any arbitrary URL value for the login URL.

After successfully creating the application, you can stay on the Home page or navigate to the "Application View" to create and configure additional entities under your new application.

Step 4: Account Settings

To manage anything related to your company's Wristband account, click on the Avatar icon in the top-right corner of the Navbar to access links that will take you to various Account Settings for your Wristband account.

Need Help?

If you have any questions or need assistance, check out our Support Information for more details.