Skip to main content
Connect Addigy so the agent can check a client’s Macs and act on them through Addigy MDM. One API key from your top-level Addigy organization covers every client. The agent reads device data on its own. It restarts a Mac, deploys a profile or deletes a user account only after a technician approves.

Prerequisites

  • You need to be an owner of your top-level organization in Addigy.
  • Your Addigy organization needs at least one policy or one device. Rallied reads the organization from them when you connect.

How to connect

1

Create an API key in Addigy

Sign in to Addigy and open Account → Integrations → API. Create an API key named Rallied and give it these permissions:Leave Execute commands off to keep the agent read-only.
2

Connect Addigy

In Rallied, go to Settings → Integrations, find the Addigy card, and click Connect. Paste the key into API Key. There is no organization ID to enter.
3

Confirm the connection

Rallied checks the key’s permissions and refuses a key without View Devices and View System Events. If a permission is missing, add it to the key in Addigy and connect again.

Mapping policies and organizations to clients

When you connect, Rallied syncs the top-level policies and child organizations in your Addigy account. Match each one to a Rallied client on the Companies tab of the integration’s detail page. Click Sync from Addigy to pick up policies and organizations you’ve added since. The agent can’t read a client’s Macs until its policy or organization is matched. On a client’s ticket, the agent reads and acts on that client’s Macs only.
A Mac that sits in policies of two different clients is shown to neither client. Fix the Mac’s policy in Addigy to make it visible again.

How the agent uses it

For a request like “Sarah’s MacBook keeps freezing”, the agent finds the Mac by name, serial number, hostname or current user. It then checks when the Mac last checked in, reads its alerts and installed software, and looks through its audit log. If a restart would help, the agent proposes one in its plan and waits for approval. Restarting a Mac doesn’t warn the user first, so unsaved work is lost. Deleting a user account also removes its home folder.

Tools

Reads default to Auto. Actions default to Approval needed. To change a default, open the Policies tab on Settings → Integrations → Addigy. See Approval settings. Addigy records a Mac’s user accounts only after an MDM Request User List command, which its API can’t send. An empty list from addigy-list-device-users means Addigy has no user list for that Mac yet, not that the Mac has no users.

See also