Addigy to JSM Assets

Import device data from Addigy to Assets.

Configure the connection to Addigy by going to OnLink (Manage your apps) - Connections. Then click on Add System and select “Other Data Sources” option in the connection screen.

Here you can set the API URL and API Key from Addigy.

API URL format is: https://api.addigy.com/api/v2/o/<your org id>

Use this link to get the Integration Key https://support.addigy.com/hc/en-us/articles/16938210315411-API-Documentation-v2

Getting an API key in Addigy

In Addigy go to Account > Integrations
In the Addigy API section's V2 tab, click on New API Token
Choose the permissions you wish to allow for this API token. Use the rule of least privilege, giving the API key only the permissions needed to achieve what you need.
Copy the token and store it in a secure location. You will NOT be able to access the key again inside Addigy.

Once connection is established, please review instructions here to get started with setting up an Assets import configuration. You can then access OnLink app from the “Manage your apps” menu to further configure and set the field level mapping. Here’s an example mapping configuration:

key:udid=id
map:device_name=Device Name
map:device_model_name=Model Name
map:serial_number=Serial Number
map:product_name=Product Name
map:identity_email=Email
map:identity_mobile_phone=Mobile
map:online=Online
map:last_online=Last Online
config:api=devices

Here’s a breakdown of some of the mapping configuration items:

Key or Map	Description

Key or Map	Description
`key:udid=id`	The keyword “key” refers to using id as a unique identifier. This allows OnLink to update the record. “id” is a text attribute.
`map:device_name=Device Name`	Maps name to Device Name text attribute
`map:device_model_name=Model Name`	Maps model name to Model Name text attribute
`config:api=devices`	Use this config to pull list of devices `config:api=devices` Any fields from this API can be included.

OnLink processes data in two steps - Get Data and Import Data. To manually test, you can click on Get Data first and then wait until you see “No more pending records. Data will be imported on next Import run.” message in Job Logs. Then, click on Import. Production runs are fully automated based on the schedule you choose.