Create an OAuth2 Client

An OAuth2 Client enables your application to communicate with Wristband.

After creating your application, you'll next need to create an OAuth2 client. OAuth2 clients are required to initiate Wristband authentication flows and to interact with Wristband APIs.


Creating Your Client

  1. Inside the Application View for your newly created application, select "OAuth2 Clients" from the left navigation bar.
  2. On the right side of the dashboard, click the "Add Client" button. This will present you with a modal to create your client.
OAuth Clients Dashboard View. Highlighed left side navigation, OAuth2 Clients. Right side highlighted button for Add Client.

Provision a Backend Server Client

When creating a new OAuth2 Client, you'll first need to select the type of client you want to create. The type of the client should correspond to the type of application you're building. For example, if you're building a web application that utilizes a backend server, then you should select "Backend Server" as the client type, if you're building a desktop or mobile application then you should select "Native", and if you're building a pure Single Page App (SPA) with no backend then you should select "Single Page App". For this quickstart guide, we'll be demonstrating how to configure the client for a Backend Server.


Dialog: Selecting your client type.
  1. Select "Backend Server".
  2. Provide a "Client Name". This is an arbitrary name that is used to identify your clients.
  3. Provide a "Callback URL". The callback URL is the endpoint within your application that Wristband will redirect to after authenticating the user. For example, if your application is running locally, then the callback URL might be set to a value like:http://localhost:3001/auth/callback.
  4. Click "Create".
  5. Success! Your client has been created.

Copy Client ID and Secret

Make sure to copy the values from the "Client ID" and "Client Secret" fields displayed in the success dialog. These values will be needed to configure your SDK in future steps of this quickstart guide. If you misplace your client secret, you can rotate the client secret to create a new one.

Success Dialog.

What’s Next

In the next section, we'll create a new tenant, which is a precursor to provisioning our first user.