Generating an API token

How to create an API token to talk to HR Duo via the public API securely

To generate an API key, you must have the Manage Public API permission.

  1. Click on the settings cog ⚙️ and select Company Settings

  2. Navigate to Public API in the left-hand menu.

  3. Click Add New API Key and give it a meaningful name (e.g., its purpose).

  4. Copy and store the generated API key securely—it will not be shown again.

Important: This token acts as a privileged user with access to all data exposed through the API. Handle it with care to prevent accidental data leakage.

You can now use this key to access the HR Duo API. See the full API documentation here: HR Duo API Docs.