Rootly
Connect Rootly to Ploy to see every user in your Rootly organization, their incident role and on-call role, which teams they belong to, and who is on call on each schedule. Ploy can also change a user's roles, remove users, and add or remove people from teams.
This integration is in beta
The Rootly integration is in beta. It was built from Rootly's API documentation and has not yet been checked against a live Rootly organization, so some details may need adjusting once customers connect it. Beta does not limit what the integration can do.
The first step of setup is a consent checkbox. Ticking it lets Ploy capture redacted error data when a request to Rootly fails: the error response Rootly sends back, with personal details, keys and other secrets removed. Ploy uses it only to fix problems with this integration. You must tick the box to continue.
What Ploy reads
Every user in your Rootly organization, with their name and email address
Each user's incident role and on-call role (shown in Ploy with "(on-call)" after the role name)
Every team, and the members of each team, including who is a team admin
Every on-call schedule, and who is on call on it now and over the next two days, overrides included
Ploy does not read your incidents, alerts, secrets, webhooks or workflows.
Before you start
You need to be a Rootly owner or admin to create a Global API key.
Every Rootly API key has an expiry date, at most five years ahead. Note it, and replace the key in Ploy before it expires.
Create an API key in Rootly
Sign in to Rootly as an owner or admin.
Open Organization Settings, then API Keys.
Create a new key and choose Global (organization-wide). Do not use a personal or team key: a team key only sees one team.
Give the key a name such as Ploy and an expiry date.
Choose a role and an on-call role for the key that can read and change users, teams, roles and schedules. If you only want Ploy to read, a role that can read them is enough.
Create the key and copy it straight away. Rootly shows it only once. Treat it like a password.
Connect Rootly in Ploy
In Ploy, open Integrations and choose Rootly.
Tick the beta consent checkbox.
Paste the API key.
Click Test. Ploy reads your Rootly users to check the key works.
Finish the setup. The first scan starts straight away.
Things to know
Users and who is on call are checked every hour. Teams and their members are checked every six hours.
Rootly has no suspended state for a user. A user deleted from Rootly loses their access in Ploy at the next scan.
Removing a person from Ploy deletes their Rootly user. This cannot be undone from Ploy.
Rootly's API cannot create users. Invite new people in Rootly, or sign them in through your identity provider.
A user holds one incident role and one on-call role. Giving another role of the same kind swaps it. Removing a role leaves the user with no role of that kind.
Ploy can only give a role that at least one person in your organization already holds.
Team changes from Ploy add people as team members. Make someone a team admin in Rootly.
Rootly limits how many requests an API key can make each minute. On a large organization the first scan may take a while to finish.