DeployHQ

Overview

The DeployHQ integration connects your DeployHQ account to Oneleet and syncs its users, so Oneleet can track who has access to your deployments.

What does Oneleet monitor?

• DeployHQ users, including whether they’re an account administrator and which account permissions they have (managing users, billing, projects, and network agents)

DeployHQ’s API doesn’t report whether a user has two-factor authentication enabled, or whether your account requires it, so Oneleet can’t check it.

Setup

To set up the DeployHQ integration, navigate to Integrations > Add integration > DeployHQ and click Continue.

Oneleet requires your DeployHQ account subdomain, the email address of a DeployHQ account administrator, and a read-only API key created by that user.

Creating a read-only API key

1. Copy your account subdomain from the address bar. For https://yourcompany.deployhq.com, the subdomain is yourcompany
2. Go to Settings, and under Personal select Security
3. Under API Credentials, enter a description for the new key and check Read-only (can only call read endpoints)
4. Click Create API Key and copy the key. DeployHQ shows it only once

For more information, see the DeployHQ API documentation.

Connecting to Oneleet

1. Enter your DeployHQ account subdomain
2. Enter the email address you sign in to DeployHQ with
3. Paste the API key
4. Click Submit

Oneleet validates the credentials by querying the DeployHQ API, and creates the connection if they’re valid.