addigy-integration-setup.md

Addigy integration

{% hint style="info" %} If you’re new to integrations in Rewst, read through our introductory integration documentation here. {% endhint %}

What does the Addigy integration do?

Our Addigy integration enables the automation of Apple device management and monitoring. Use the Addigy API within Rewst workflows to create, read, update, or delete managed devices, and access monitoring functionality.

Set up the Addigy integration

Set up steps in Addigy

1. Log in to your Addigy account.

2. Navigate to https://app.addigy.com/integrations.

3. Scroll down the page to the Addigy API submenu.

4. Click the V2 tab.

5. Click New API Token.

6. Set your appropriate name and permissions for your V2 API token.

7. Click Add.

8. Copy the v2 token value from the new token section of the V2 tab. Store it somewhere secure, as you'll need it for further steps in Rewst. Note that once you leave this page, you won't be able to see the token again.

9. Copy the Parent Organization ID. This will be displayed under the Addigy API submenu title.
   
   

   

10. Click the V1 tab of the Addigy API submenu.

11. Click New API Token.

12. Set your appropriate name and permissions for your V1 API token.

13. Click Add.

14. Copy the V1 Client ID and Client Secret. Store the information somewhere secure, as you'll need it for further steps in Rewst. Note that once you leave this page, you won't be able to see the token again.
    
    

Set up steps in Rewst

1. Navigate to Marketplace > Integrations in the left side menu of your Rewst platform.
2. Search for Addigy in the integrations page.
   
   
3. Click on the integration tile to launch the configuration setup page.
4. Under Parameters, paste the information copied from Addigy into the relevant fields:
   1. Parent Organization ID
   2. V1 Client ID
   3. V1 Client Secret
   4. V2 API Key
5. Click Save Configuration.
6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.

{% hint style="success" %} Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our Canny feedback collector. {% endhint %}

Actions and endpoints

{% hint style="info" %} For more on how actions work in Rewst, check out our introductory actions documentation here. {% endhint %}

Category	Action	Description	Required permissions
Apps And Books	List Of Apps And Books Tokens Assigned To Policies	Get a list of apps and books tokens assigned to policies
Automatic Device Enrollment	List Ade Tokens Assigned To Policies	Get a list of ADE tokens assigned to policies
Autotask	List Autotask Accounts	Get Autotask account
Autotask	Get Autotask Account	Get Autotask account
Autotask	Sync Policy Devices With Autotask Configurations	Sync policy devices with Autotask configurations.	Permission required: Edit Integration
Azure Conditional Access	Get Azure Conditional Access All Accounts Metadata	Get Azure Conditional Access all accounts metadata
Benchmark	Update A Benchmark Asset	Update a benchmark asset.	Permission required: Edit Benchmark
Benchmark	Create A Benchmark Asset	Create a benchmark asset.	Permission required: Create Benchmark
Benchmark	Delete A Benchmark Asset	Delete a benchmark asset	Permission required: Delete Benchmark
Benchmark	Assign A Benchmark To A Policy	Assign a benchmark to a policy	Permission required: Edit Policy Benchmarks
Benchmark	Remove A Benchmark From Policy	Remove a benchmark from a policy	Permission required: Edit Policy Benchmarks
Benchmark	List Benchmark Assets	Get a list of benchmark assets for an organization	Permission required: View Benchmarks
Billing	Get Billing Account	Get billing account for a given organization
Billing	Get Billing Data	Get billing data for a given child organization
Billing	Get Billing Invoices	Get billing invoices for a given organization
Child Organizations	List Child Organizations	Get a list of child organizations belonging to the provided organization
Commands	Run Devices Command	Run devices command
Commands	Get Command Output	Get command output
Community	Report Community Fact Or Command	Report a community fact or command to Addigy for review
Compliance Rule	Update A Compliance Rule	Update a compliance rule	Permission required: Edit Benchmark
Compliance Rule	Create A Compliance Rule	Create a compliance rule	Permission required: Create Benchmark
Compliance Rule	Delete A Compliance Rule	Delete a compliance rule	Permission required: Delete Benchmark
Compliance Rule	Get Compliance Rules Using A Script	Get compliance rules using script	Permission required: View Benchmarks
Compliance Rule	List Compliance Rules	Get a list of compliance rules for an organization	Permission required: View Benchmarks
Compliance Rule	Get A Compliance Rule Usage	Get a compliance rule usage	Permission required: View Benchmarks
Configurations	List API Key Permissions	Get API key permissions
Connectwise	List Connect Wise Accounts	Get ConnectWise account
Connectwise	Get Ticketing Account	Get ticketing account
Connectwise	Sync Policy Devices With Connect Wise Configurations	Sync policy devices with ConnectWise configurations	Permission required: Edit Integration
Device Compliance Status	Get Device Compliance Statuses Per Benchmark	Get device compliance statuses per benchmark	Permission required: View devices
Device Compliance Status	List Devices Compliance Status	Get devices compliance status	Permission required: View Devices
Device Script Assignments	List Device Script Assignments	Get Device Script Assignments available for the organization
Device Script Assignments	Creates A Device Script Assignment	Creates a device script assignment in the organization
Device Script Assignments	Deletes A Device Script Assignment	Deletes a device script assignment from the organization
Devices	Universal Search Devices	Allow to query for a set of devices based on a value that pertains to one of their device facts	Permission required: View Devices
Devices	Removes A Device	Removes a device from Addigy Note: This endpoint is not meant to be used by bulk removal operations.	Permission required: Delete Devices
Facts	List Custom Facts	List all custom facts for the organization
Facts	Update Custom Facts	Update a custom fact
Facts	Create Custom Facts	Create a custom fact.
Facts	Delete Custom Facts	Delete a custom fact
Facts	Assign Custom Fact To Policies	Assign Custom Facts to policies
Facts	Unassign A Custom Fact From A Policy	Unassign a custom fact from a policy
Facts	List Of Custom Facts Filtered By ID Or Name	Get a list of Custom Facts filtered by id or name for an organization
Files	List Organization Files	Get a list of files for an organization	Permission required: View Files
Generic Request	Addigy API Request	Include /v2/ for Addigy API v2 usage, generic action for making authenticated requests against the Addigy API
Installed Apps	Query Installed Apps From A Device (Via Mdm)	Query installed apps from a device providing some agent IDs	Permission required: View Devices
Maintenance	Update Maintenance Item	Update a maintenance item	Permission required: Edit Catalog Maintenance
Maintenance	Create Maintenance Item	Create a maintenance item	Permission required: Create Catalog Maintenance
Maintenance	Delete Maintenance Item	Delete a maintenance item	Permission required: Delete Catalog Maintenance
Maintenance	Assign Polices To A Maintenance Item	Assign polices to a maintenance item	Permission required: Edit Policy Maintenance
Maintenance	Unassign A Maintenance Item From Policy	Unassign a maintenance item from policy	Permission required: Edit Policy Maintenance
Maintenance	List Maintenance Items	Get a list of maintenance items for an organization.
Malwarebytes Oneview	Enable Malware Bytes One View Integration. Create New Account	Enable MalwareBytes OneView integration, create new account
Malwarebytes Oneview	Disable Malware Bytes One View Integration	Disable MalwareBytes OneView integration.
Malwarebytes Oneview	Get Malware Bytes One View Account Status	Get MalwareBytes OneView account status
Malwarebytes Oneview	Get Malware Bytes One View Account Catalog Usage	Get MalwareBytes OneView account catalog usage
Malwarebytes Oneview	Get Malware Bytes One View Sites	Get MalwareBytes OneView sites
Malwarebytes Oneview	Get Malware Bytes One View Policy Sites	Get MalwareBytes OneView policy sites
Malwarebytes Oneview	Assign A Malware Bytes One View Site To A Policy	Assign a MalwareBytes OneView site to a policy
Malwarebytes Oneview	Remove A Malware Bytes One View Site From Policy	Remove a MalwareBytes OneView site from policy
Managed Apps Configurations	Gets Managed App Configuration For Apps & Books Applications	Gets managed app configuration for Apps and Books applications
Managed Apps Configurations	Requests To Create Managed App Configuration For Apps & Books Applications	Requests to create managed app configuration for Apps and Books applications
Managed Apps Configurations	Requests To Delete Managed App Configuration For Apps & Books Applications	Requests to delete managed app configuration for Apps and Books applications
Managed Apps Configurations	Requests To Assign Managed App Configuration To Apple Application	Requests to assign managed app configuration to Apple application
Managed Apps Configurations	Gets Managed App Configurations For A Location	Gets managed app configurations for a location
Mdm Commands	Clear Passcode	This command allows the server to delete a user that has an active account on the device-Please provide the device agent ID or the device UUID
Mdm Commands	Delete Device User	This command allows the server to delete a user that has an active account on the device-Please provide the device agent ID or the device UUID
Mdm Commands	List Mdm Device Users	Returns a list of known users that were given to Addigy via the Request User List command -Please provide the device agent ID or the device uuid
Mdm Commands	Lock Mdm Device	This command locks the device. The device will be unusable until the passcode is entered.Please provide the device agent ID or the device UUID
Mdm Commands	Disable Lost Mode	This command allows the server to put the device in MDM lost mode, with a message, phone number, and footnote text. A message or phone number must be provided.Please provide the device agent ID or the device UUID
Mdm Commands	Enable Lost Mode	This command allows the server to put the device in MDM lost mode, with a message, phone number, and footnote text. A message or phone number must be provided.Please provide the device agent ID or the device UUID
Mdm Commands	Get Device Location	Allows the server to ask the device to report its location if it is in MDM lost mode. Please provide the device agent ID or the device UUID.
Mdm Commands	Restart Mdm Device	Description coming soon...
Mdm Configuration Profiles	Get Mdm Configuration Profile Definition	Addigy payload type of MDM profile
Mdm Configuration Profiles	Get Mdm Configuration Profile Definitions	Get MDM configuration profile definitions
Mdm Configuration Profiles	Get Policy Profiles By Addigy Payload Type	Get policy profiles by Addigy payload type
Mdm Configuration Profiles	Creates An Mdm Profile	Creates an MDM profile
Mdm Configuration Profiles	Assign Policies To Manifest Based Mdm Configuration Profile	Assign policies to manifest-based MDM configuration profile
Mdm Configuration Profiles	Unassign An Mdm Profile From Policies	Unassign an MDM profile from policies
Mdm Configuration Profiles	Get Manifest Based Mdm Configuration Profile	Get manifest-based MDM configuration profile
Mdm Configuration Profiles	Delete Manifest Based Mdm Configuration Profile	Delete manifest-based MDM configuration profile
Mdm Configuration Profiles	Get Manifest Based Mdm Configuration Profiles	Get manifest-based MDM configuration profiles
Mdm Configuration Profiles	Update A Manifest Based Mdm Configuration Profile	Update a manifest-based MDM configuration profile
Mdm Configuration Profiles	Confirm Changes To Manifest Based Mdm Configuration Profile	Confirm changes to manifest-based MDM configuration profile
Mdm Configuration Profiles	Query Mdm Payload Information	Query MDM Payload information and assignments
Mdm Devices	Get Mdm Device Details	Get MDM device details including enrollment profile, APN certificate and last response
Mdm Devices	Test Mdm Response	Test MDM response
Mdm Enrollment	Install Mdm Enrollment Profile	Install MDM enrollment profile via mdm if available or via agent for macOS devices
Mdm Installed Certificates	List Of Mdm Installed Certificates	Paginated request that returns list of installed certificates by mdm devices	Permission required: View Devices
Mdm Profile Deployment	Deploy Profile To List Of Devices	Deploys profile to list of devices andor managed users. It is an atomic request meaning that if one error is encountered no profile will be deployed to any of the devices and/or managed users	Permission required: View Devices, Execute commands
Mdm Profiles	List Mdm Profiles
Mdm Profiles Policies	List Mdm Profiles Assigned To Policies	Get MDM profiles assigned to policies
Monitoring	Update A Monitoring Item	Update a monitoring item	Permission required: Edit Custom Monitoring.
Monitoring	Create A Monitoring Item	Create a monitoring item	Permission required: Create Custom Monitoring
Monitoring	Delete A Monitoring Item	Delete a monitoring item	Permission required: Delete Custom Monitoring
Monitoring	Assign Monitoring Item To Policy	Assign monitoring item to policy	Permission required: Edit Policy Monitoring
Monitoring	Unassign A Monitoring Item From Policy	Unassign a monitoring item from policy	Permission required: Edit Policy Monitoring
Monitoring	List Monitoring Items	Get a list of monitoring items for an organization.
Monitoring	List Of Received Alerts	Query list of received alerts
Office Updates	Assign Office Update Asset To Policy	Assign office asset to policy	Permission required: Edit Policy Instruction
Office Updates	Remove Office Update From A Policy	Remove office update from a policy	Permission required: Edit Policy Instruction
Os Users	Assigns OS User Asset To A Policy	Assigns an OS user asset to a policy	Permission required: Edit Policy Instructions
Os Users	Unassigns OS User Asset From A Policy	Unassigns an OS user asset from a policy	Permission required: Edit Policy Instructions
Policies	Update A Policy	Update a policy.	Permission required: Edit Policy
Policies	Create A Policy	Create a policy	Permission required: Create Policy
Policies	Delete A Policy	Delete a policy	Permission required: Delete Policy
Policies	Update A Policy Parent	Update a policy parent	Permission required: Edit Policy
Policies	Delete A Policy Parent	Delete a policy parent	Permission required: Edit Policy
Policies	Get Policy Info	Query an organization for all policies or filter to get specific policy info
Policy Rules	Get Policy Assignment Rule	Get policy assignment rule	Permission required: Automatic Policy Assignments
Policy Rules	Add Assignment Rule To Policy	Add assignment rule to policy	Permission required: Automatic Policy Assignments
Policy Rules	Remove Assignment Rule From Policy	Remove assignment rule from policy	Permission required: Automatic Policy Assignments
Policy Rules	List Policy Assignment Rules	Get policy assignment rules	Permission required: Automatic Policy Assignments
Public Beta Features	Get Public Beta Features	Get all Beta Features available for the organization	Permission required: Update Feature Beta Status
Public Beta Features	Enables A Beta Feature In The Organization	Enables a Beta Feature in the organization	Permission required: Update Feature Beta Status
Public Beta Features	Disables A Beta Feature From The Organization	Disables the Beta Features from the organization	Permission required: Update Feature Beta Status
Reports	Request Report	Request a report. Only one report of each type can be requested at a time
Reports	Get A Report	Get a report
Reports	List Available Reports	Get a list of available reports
Reports	List Report Statuses	Get report statuses
Script	Delete Script	Delete a script	Permission required: Delete Predefined Commands
Self Service Configuration	Create Self Service Configuration	Creates a new self service configuration in the organization	Permission required: Create Instruction
Self Service Location Assets	List Of Available Assets For The Provided Location ID (Token ID)
Smart Software	Assigns A Smart Software Item To A Policy	Assigns a Smart Software Item to a Policy given the Policy ID and Smart Software Item ID	Permission required: Edit Policy Instructions
Smart Software	Unassigns A Smart Software Item From A Policy	Unassigns a Smart Software Item from a Policy given the Policy ID and Smart Software Item ID	Permission required: Edit Policy Instructions
Smart Software	Create A New Smart Software	Creates a new smart software	Permission required: Create Instruction
Smart Software	List Of Smart Software Items	Gets a list of smart software items available for the given organization.Items returned can be filtered based on query parameters from the request. To query for the versions of a software, provide the identifier of the software in the query.
Smart Software	Gets A Smart Software Item	Gets a smart software item by ID
Smart Software	Creates A New Version Of A Smart Software	Creates a new version of a smart software	Permission required: Create Instruction
Static Fields	List Static Fields	Gets a list of all static fields available for the organization	Permission required: View Devices
Static Fields	Updates An Existing Static Field	Updates the name of an existing static field in the organization	Permission required: View Devices
Static Fields	Creates Static Fields	Creates a new static field in the organization	Permission required: View Devices
Static Fields	Removes A Static Field	Removes the static field from the organization	Permission required: View Devices
Static Fields	List Static Fields Assigned To Devices	Gets a list of all static fields assigned to devices for the organization	Permission required: View Devices
Static Fields	Assign A Static Field To Device(S)	Assign static field values to device(s) in the organization	Permission required: View Devices
System Events	List System Events	Allows listing system events with highlighting	Permission required: View System Events
System Events	Search System Events	Allow to search system events	Permission required: View System Events
System Updates (Mdm)	Gets Available System Updates Reported For A Device	Gets available system updates reported for a device	Permission required: View Device List
System Updates (Mdm)	Requests Available System Updates For A Device Via Mdm Command	Requests available system updates for a device via MDM command	Permission required: View Device List, Execute Predefined Commands
System Updates (Mdm)	Gets Available System Updates Reported For A Device, With Their Current Installation Statuses	Gets available system updates reported for a device, with their current installation statuses	Permission required: View Device List, Execute Predefined Commands
System Updates (Mdm)	Gets Installed System Updates Reported For A Device	Gets installed system updates reported for a device	Permission required: View System Updates Settings, View Device List
System Updates (Mdm)	Requests To Send Installed System Updates Reported For Policy Devices To User Email	Requests to send installed system updates reported for policy devices to user email	Permission required: View System Updates Settings
System Updates (Mdm)	Requests To Schedule System Updates (On Demand) For Devices Via Mdm Command	Requests to schedule system updates (on-demand) for devices via MDM command
System Updates (Mdm)	Requests To Schedule System Updates (On Demand) For Policy Devices Via Mdm Command	Requests to schedule system updates (on-demand) for policy devices via MDM command
System Updates (Mdm)	Requests A System Updates Scan For A Device Via Mdm Command	Requests a system updates scan for a device via MDM command	Permission required: View Device List, Execute Predefined Commands
System Updates (Mdm)	Requests The Schedule Of System Updates Via Mdm Command	Requests the schedule of system updates via MDM command	Permission required: View Device List, Execute Predefined Commands
System Updates (Mdm)	Gets System Updates Settings For A Policy	Gets system updates settings for a policy	Permission required: View System Updates Settings
System Updates (Mdm)	Requests To Create Or Update System Updates Settings For A Policy	Requests to create or update system updates settings for a policy
System Updates (Mdm)	Gets Current System Updates Statuses Reported For A Device	Gets current system updates statuses reported for a device	Permission required: View Device List, Execute Predefined Commands
System Updates (Mdm)	Requests System Updates Statuses For A Device Via Mdm Command	Requests system updates statuses for a device via MDM command	Permission required: View Device List, Execute Predefined Commands
Users	List Organization Users	Query for organization users	Permission required: View Users
Users	Update A User	Update a user	Permission required: Edit User
Users	Create User	Create a user	Permission required: Create User
Users	Deletes A User From The Organization	Deletes a user from the organization	Permission required: Remove User
Variables	Update A Variable	Update a variable	Permission required: Edit Variable
Variables	Create A Variable	Create a variable	Permission required: Create Variable
Variables	Delete A Variable	Delete a variable	Permission required: Delete Variable
Variables	Get Policy Variable Value	Get policy variable value	Permission required: Edit Policy
Variables	Assign Policy Value To A Variable	Assign policy value to a variable	Permission required: Edit Policy
Variables	Remove Policy Value From A Variable	Remove policy value from a variable	Permission required: Edit Policy
Variables	Get Variable Usage	Get variable usage.	Permission required: View Variable
Variables	Get Variable Value	Get variable value.	Permission Required: View Variable
Variables	List Variables for Organization	Get a list of variables for an organization	Permission Required: View Variables