Liongard Integration - Getting Started

A step-by-step guide to getting started with the Liongard Integration with Gradient MSP.


Ready to get ROARING with automated billing reconciliation using Liongard? Let's get started by first connecting the integration. The Liongard integration allows you to sync product usage from custom metrics, so you can quickly reconcile services in Synthesize.


To use the integration, you need to these 3 things. 

1) An Access Token from Liongard

2) A custom metric in Liongard

3) Connect the Liongard Integration in Syntheszie 

Get an Access Token from Liongard

  1. Login to Liongard
  2. Select your Profile (top-right)
  3. From the dropdown menu, select Account Settings
  4. Select Access Tokens
  5. Click Generate New Token and choose Liongard API Token
  6. Record your New tokens and Liongard Instance for use in Synthesize Billing.

Note Please keep your key in a secure place and do not share it. You will not be able to get your Access Key Secret again unless you were to generate a new access token.



Create a Custom Metric in Liongard

Note If you haven't done so already, please review the Liongard Requirements.

  1. Login to Liongard.
  2. Go to Admin > Metrics.
  3. Add Metric or Clone from existing Metric.
  4. Select Inspector.
  5. Give the Metric a name and prefix with 'Gradient' (Synthesize Billing filters custom Metrics by this prefix).
  6. Ensure Metric Display is enabled.
  7. Choose a System Inspector from the dropdown in the Query Builder.
  8. Enter a JMESPath query for the Data Print in the Data Print Query.
  9. Ensure the Query Results evaluates a whole number, and validate this quantity is correct by reviewing the Data Print, drilling into each array and object.


Connect Liongard Integration in Synthesize Billing

Step 1: API Authentication

  1. Login to Synthesize.
  2. Go to integrations.
  3. Hover over the Liongard integration card, and click Connect.
  4. Input your Instance (This can be found from your Liongard URL. For instance, if your Liongard URL is, your Instance would be us1), Access Key ID, and Access Key Secret. 
  5. Click Authenticate.
  6. Once successfully authenticated, continue on to the next step in the Liongard Integration Wizard.


Step 2: Map Accounts to Environments

It's recommended that all your Accounts in Synthesize Billing be mapped. Drag and drop the accounts from Synthesize on the left to the environments from Liongard on the right.

When you are ready, click Next.

Step 3: Map Services to Custom Metric

Drag and drop from the list of Services in Synthesize on the left, with Custom Metrics found in Liongard on the right. These will be used to automatically reconcile billing for these services.
When you are ready, click Next.

Note that Multiple services can be mapped to a single metric. Not sure where to start? Check out some Use-Case Scenarios or Liongard Sample Metrics to get your creative juices flowing!

Step 4: Review and Confirm

Once validation is successful, you'll be given an opportunity to review and confirm. When you are ready, click Finish to start syncing information into Synthesize Billing.

Tip Sample Data will further provide you with an opportunity to validate the data to ensure the quantities you are importing are correct. You can double-check these evaluated numbers by reviewing System Inspector queries from the Metric(s) you created from the previous steps.

Step 5: Service Reconciliation

Congratulations, you're almost there! Once the sync is complete, you can immediately start reconciling the services you've mapped to Metrics.

To make your life easier, use the filter by vendor tag, select Liongard and start reconciling!

Note When you map a service to a custom metric with the Liongard Integration, the service will automatically be tagged with a vendor tag 'Liongard'.

Tip Want some further inspiration? Check out some Use-Case Scenarios or Liongard Sample Metrics to get you started!