Getting Started

Let's get building! Here are the steps to getting started.

Step 1: Create a Client Application

Navigate to the Applications page of the Willow User Management app and select Public API v3. On the Clients tab, select Add Client.

Add Client Application

Complete the Add Client details.

Add Client Application Modal

Select Edit Client where you will see the Client Id. Next, select Generate Secret and the Client Secret will be generated. If an expiration was selected, the expiration date will also be shown. Be sure to copy both of these values as they will be used for authentication.

Generate Secret

warning

The Client Secret will not be visible again after leaving the Edit Client modal. If you have forgotten the secret, select Rotate to generate a new one.

Step 2: Add Permissions

Now that we've created the Client Application and generated credentials, it's time to add permissions to the Client Application. On the Assignments tab, select Add Assignment.

Add Assigment

Select your Client and the Permissions you would like to make available via the API.

Add Assigment

Option

You can select a Location to restrict the credentials from only accessing a specific Location's data.

Step 3: Get a token

See Authentication Endpoints for details on how to use your credentials to get an access token.

Copyright © 2024 Willow. All rights reserved.