Intro

ITGlue is a documentation service. This page guides you through the process of setting up an integration via the ITGlue API.

info

Reach out to the Pia Team via Partner Support if support is required.

Prerequisites

You will need the following details before setting up your ITGlue integrations. (More details about these items can be found where you enter them in the sections below.)

• API URL
• API Key
• Flexible Asset Type

Set Up Process

Here is a quick intro to setting up a new Integration. Details for the fields specific to each service are on the pages linked below.

Summary of the set up process

• Set-up Integration
• Test Integration

Set-up Integration

1. Log in to your Pia portal.

2. In the left menu click on Integrations

3. The Integrations page opens. Search for ITGlue using the search bar at the top.

   

   Or, click on the "View All" button available in the All Integration section.

   This will open up a screen that displays all the available integrations where you can navigate to ITGlue.

4. Click on the "Configure" button available in the widget for ITGlue. This will take you to the configuration page for ITGlue.

   

   In this page, you can add a friendly name for the configuration in the "Configuration Name" field.

   

5. You will also see the following fields that need to be configured for ITGlue.

• URL: Enter the URL relevant to your geographic location:
  • Default data centre: https://api.itglue.com
  • European data centre: https://api.eu.itglue.com
  • Australian data centre: https://api.au.itglue.com
• API Key: Enter the 'API Key' value that you received from ITGlue.

note

For partners hosted in the Australian data centre who were migrated from the default US data centre, API access may still be restricted to the default US data centre endpoint.

• Flexible Asset Type: Enter the 'Flexible Asset Type' you set up in ITGlue to receive information from Pia.
  See below at the bottom of the page if you need to create Flexible Asset for ITGlue.

6. Click Save to commit the settings. (If any mandatory fields have been left blank you will receive an error message, and the missed field will have a red box around them.)

Test Integration

After setting up your Integration for ITGlue you will need to test the connection works.

1. Click the Test Connection button to confirm the Integration has been configured correctly.

2. You should receive a Connection Successful! popup box. If you receive a Can't connect to service. message, double-check the configuration details and try again.

The ITGlue Integration configuration is now complete.

Creating a Flexible Asset

1. Log into ITGlue as an Administrator.
2. Go to Account > Flexible Asset Types

3. On the Flexible Assets page, click on “New”

4. Create the Flexible Asset with the information below;

5. Click "Save".