Getting an JWT Authentication Token
This tutorial will take you through the basics of the FormKiQ Document API, including: adding documents, working with document tags, and searching for documents.
Prerequisite
-
You have installed FormKiQ; see the FormKiQ One-Click Installation Links for more information
-
Install either: cURL or your favorite API Client, like Postman.
-
Optionally install: JQ, a command-line JSON processor which formats JSON so it is more readable.
-
All shell commands are shown for Unix-based systems. Windows has analogous commands for each.
CloudFormation Outputs
We are going to need to know the name of a few AWS resources creating during the FormKiQ installation. Opening the CloudFormation console, find your FormKiQ stack and click the Outputs
tab.

The following are outputs we’ll need to know.
Argument |
Description |
|
The Cognito API Endpoint |
Get JWT Authentication Token
The first thing we need is a JSON Web Tokens (JWT) that will tell the API we are authorized to make the API request.
Authenticating can be done using the Cognito API Endpoint url with the following command. The descriptions of the required arguments are in the table below.
curl -X POST https://COGNITO_API_ENDPOINT_URL/login \
-H "Content-Type: application/json" \
-d '{"username": "USERNAME", "password": "PASSWORD"}'
Argument |
Description |
|
The Cognito API endpoint URL found in the CloudFormation Outputs. |
|
The administrator email address. |
|
The administrator password. |
The JSON response should return successful response like below:
{ ... "AuthenticationResult": { "AccessToken": "eyJraWQiOiJkdkpnTHlm ...", } ... }
You can use the AccessToken
to access the FormKiQ API.
NOTE The AccessToken
is only valid for 1 hour.
Summary
Throughout this tutorial, you have successfully used the FormKiQ Cognito API to authenticate against FormKiQ and retrieve an AccessToken
that can be used to access the FormKiQ API.
To learn more about how you can use the FormKiQ API to collect, organize, process, and integrate your documents and web forms, see the full list of FormKiQ Tutorials.