Authentication Endpoints

The Willow API provides authentication endpoints you will use to get an access token using the appropriate OAuth 2.0 Grant flow for your application. The following section provides details for how to get an access token.

Base URLs

The following base URLs should be used depending on the environment you are seeking to authenticate with:

Production

Copy

Copied

https://<organization>.app.willowinc.com/api/v3

where you replace <organization> with your Willow-provided organization name.

Development Sandbox (Coming Soon)

Developers will soon be able to leverage a Willow platform sandbox environment to authenticate and make API calls to test their integration.

Get an Access Token

POST /oauth2/token

Description

Used to acquire a new access token. This endpoint represents the token endpoint described in OAuth 2.0 RFC - Section 3.2. The parameters described below are placed in the body of the request.

Body Parameters

Copy

Copied

{
    "client_id": "<YOUR_CLIENT_ID>",
    "client_secret": "<YOUR_CLIENT_SECRET>",
    "grant_type": "client_credentials"
}

Response Body

The response will include your access token and expiration deetails used to make API calls to the other endpoints.

Copy

Copied

{
    "token_type": "Bearer",
    "expires_in": 3599,
    "ext_expires_in": 3599,
    "access_token": "<YOUR_ACCESS_TOKEN>"
}