Your Account Details

Adding your Account Details

The Partner API requires a JWT access token along with your API_KEY to authenticate and authorise your access to the API. The token can be retrieved using the built in OAuth2 form within Postman.

Add your account details to the OAuth form

To add your Partner API account details to Postman click on the topmost folder in your collection called Genie FHIRworks.

Configure Authorisation

You should now see a page listing Authorisation options. From the Type dropdown select OAuth2.

Selecting OAuth2 will display a large form which needs a few values added to allow your Postman to retrieve a token for use in the Partner API.

Insert the values below until your form has all required values:

Field	Value
Token Name	COGNITO_TOKEN
Grant Type	Authorization Code (with PKCE)
Callback URL	http://localhost
Auth URL	{{ AUTH_URL }}
Access Token URL	{{ TOKEN_URL }}
Client ID	{{ CLIENT_ID }}
Client Secret
Code Challenge Method	SHA-256
Code Verifier
Scope	openid email profile
State
Client Authentication	Send client credentials in body

Retrieve your access token

You should now have all the details in place you need to retrieve an access token.

Click on the Get Access Token button to bring up the login dialog

Enter in the username and password you used to create your Partner API account, click Login, and after a short time you should see the screen below. Click proceed.

When you click Proceed a screen displaying your new token will be visible. On this page you need to scroll down until you see the id_token section. This is the token that we need. Click and drag to select the token being careful to include the whole block of text. Copy the text you have selected and then close the popup window.

Next we have to paste the text you have copied in to our token field. To do this click on the input box below the Available Tokens drop down that has "Access Token" as a placeholder.

Select all the text in this window and press your backspace key. Next paste in the token we copied in the previous step.

And lastly click on the Sync button next to the input field.

And finally click on Sync Token in the confirmation window.

The Sync button should now be green indicating the value is available to your requests.