How to set up an OAuth2 Access Token Request

To create and authorised session with the shipping API, you must retrieve an authorisation token.

There are many tools on the market that will enable you to do this, or you can simply configure your internal systems to send the request and authentication parameters. By viewing this demo, you can see how this is achieved using the postman API tool.

The steps are as follows:

  1. Capture the correct Token URL (The URL below is for the test system):
    1. https://authentication.preprod.proshipping.net/connect/token
  2. Ensure that you have set the authorisation type that you are going to send as “OAuth2”.
  3. Name your header prefix “bearer” is the most common name.
  4. Set the Flow ( sometimes referred to as “Grant”) Type to “Client Credentials”.
  5. Use the correct Token URL (whether it is for test or production) as the “Access Token URL”
  6. Supply your ClientID – this is unique to you and would have been provided upon API signup.
  7. Supply your Client Secret - this is unique to you and would have been provided upon API sign-up.
  8. Ensure the Client Authentication is set to “Send as Basic Auth Header”.
  9. Send the request for an Access Token – you should get a token within a few seconds and it will look like a long string of random data, you will also receive details on when the token will expire (in seconds).

The access token received then needs to be included in request headers.