You can obtain a token for your API Subscription token for testing an API by following these steps:

  1. Select the POST method from the available operation method dropdown list for your new request in Postman.
  2. Go to the API Subscriptions details page and then the Native OAuth Application-flow section within Find and Use an API Portal.
  3. Copy the OAuth token endpoint value. For this example, the value is 'https://login.microsoftonline.com/7d85e51f-c73e-40a8-a5c5-4c3b41de8eb9/oauth2/v2.0/token'. This will be a URL given by the token Business-to-Consumer (B-2-C) provider.
  4. Paste that URL into the new Request textbox within Postman.
  5. Select the Body tab for your new request in Postman. You will be presented with all the key and value fields requiring inputs.

Get the OAuth Client ID:

  1. Go to the API Subscriptions details page and then the Native OAuth Application-flow section within Find and Use an API.
  2. Copy the OAuth Client ID value.
  3. Paste it into the Value field for client_id Key field within the Body tab in Postman.
  4. Check the Value field for grant_type key field is set to 'client_credentials' within the Body tab in Postman.

Get the Primary key value:

  1. Go to the API Subscriptions detail page and then the Native OAuth Application-flow section withinFind and Use an API Portal.
  2. Copy the Primary key value.
  3. Paste it into the Value field for client_secret key field within the Body tab in Postman.

Get the OAuth Scope value:

  1. Go to the API Subscriptions detail page and then the Native OAuth Application-flow section within Find and Use an API Portal.
  2. Copy the OAuth Scope value.
  3. Paste it into the Value field for scope key field within the Body tab in Postman.
  4. Select the Send button to submit the request to the token provider. You will get a token back as a response. This token can be viewed within the Response Body below in the access_token field value.

Get the Access token value

  1. Go to the Response Body (in JSON format) for your submitted request in Postman.
  2. Find the field access_token.
  3. Copy this access_token value. It will look something like 'MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3'
  4. Go back to your request in Postman.
  5. Select the Authorisation tab for your new request in Postman.
  6. Go to the Type dropdown option, select Bearer token for type.
  7. Paste the access_token value you copied to the Token textbox presented to you in Postman.
  8. Select the Send button again, to submit the request with the Bearer token now added. This will return a response for the API that can be viewed within the Response body in Postman. The response will contain various fields and values including headers, any query parameters, response message and timestamp in JSON format within Postman. You can also download the JSON response file.