Authentication

Before any calls can be made to the People First APIs the client first needs to obtain authorisation in the form of a People First Access Token. A People First access token is acquired from the 'Inbound Integration' section of the settings tab within the People First Administration menu. Login to People First using your company credentials and then following authentication click the menu icon in the top left-hand corner of the landing page.

People First Base URI

The People First Base URI requires two amendments to the Tenant Code and Environment Code segments before it can be used as the basis for all of your API calls.

https://TENANT_CODE-ENVIRONMENT_CODE.people-first.com

• TENANT_CODE: This will be provided to you by MHR and is unique to your company and its group of users.

• ENVIRONMENT_CODE: This will be provided to you by MHR and is unique to the individual user unless multiple users are using the same environment

To form the People First Base URI you will need to insert your provided Tenant and Environment codes into the above URI as per the example below.

https://pegasusincorporated-johnsmith.people-first.com

• EXAMPLE_TENANT_CODE: PegasusIncorporated

• EXAMPLE_ENVIRONMENT_CODE: JohnSmith

The People First base URI is always followed by /api/v1, so the People First base URI then becomes:

https://pegasusincorporated-johnsmith.people-first.com/api/v1