Addigy Integration

Note: You should never have to generate new API keys unless setting up an entirely different instance of Addigy, which will likely not be the case. This is because we use a single instance of Addigy to manage all of our clients and have a pre-existing API key. The first part of this guide (Steps for generating the API key in Addigy) is merely for informational purposes.

Note: You should never have to generate new API keys unless setting up an entirely different instance of Addigy, which will likely not be the case. This is because we use a single instance of Addigy to manage all of our clients and have a pre-existing API key. The first part of this guide (Steps for generating the API key in Addigy) is merely for informational purposes.

READ THE NOTE ABOVE BEFORE PROCEEDING. 

Pre-requisites:

  • You MUST have ‘owner’ permissions to generate API keys in Addigy.
  • Download the Postman app from here: https://www.postman.com/downloads/
  • Current Addigy API Client ID & Secret:
Client ID
744f6442b97xxxxx36725bb9663d346fbxxxxxx

Client Secret
e750b66a68b69bc67xxxxxxxx2afe4c979e6020049d26d6b9e6ee6146429bxxxxx

Steps for generating the API key in Addigy:

  1. Open Addigy via the Google waffle
  2. Navigate to Account -> Integrations menu on the left-hand side
  3. Click the + Add API button on the right-hand side
  4. Enter a name for the key and click Save

IMPORTANT: Copy the Client ID and Client Secret before closing the window

If successful, you should see a window like the following:

Steps for retrieving the client’s Policy ID in Postman:

  1. Open the Postman app and download the following Collection:

1 attachment

json

Addigy.postman_collection.json

1.2KB

  1. Keep this JSON file handy as you will need to return to it in the next step
  2. From inside of Postman, click Import -> Upload Files -> Select the .json file you downloaded in step 1, and click Import
  3. Under the Collections section, select the dropdown next to Addigy, then select the GET request and click Send

Once those steps are completed, you should now see the successful JSON response. Each section (denoted by curly braces ‘{ }’) of the JSON response represents an individual company that we manage inside of Addigy, and within each section there is a “policyId”. 

IMPORTANT: For the purposes of Wizarrd, copy the policyId string between the quotation marks for the company that you’re going to import Addigy data for.

Example:

Configuring Wizarrd to import the Addigy data:

  1. Navigate to the appropriate client’s company under https://console.wizarrd.app/companies
  2. Select the Machine Management tab and expand Addigy
  3. Enter the Client IDClient Secret, and Policy ID (unique to the company), check “Is Active Account.”, and click Update.

Example:

Once completed, make sure to copy the API information and put it in the API Keys section of the relevant client.