Skip to main content

HR Partner setup

HR Partner connects through the unified HRIS connector. This page covers the HR Partner-side configuration you complete first. Once it's done, add the connector in Mesh by following Connect your HR system.

You finish with one value: an API token.

Before you start

You need to be an admin in your company's HR Partner instance.

Third-party product

These steps reflect Axiad's current understanding of HR Partner's configuration. Because HR Partner is a third-party product, there may be variations between your experience and what this guide describes, depending on the version in use and recent updates.

If you find a significant difference, or anything that doesn't make sense, let us know through Axiad support.

Step 1 — Open integration settings

Sign in as an admin, select Setup in the left navigation, then Configure → Integrations.

The HR Partner setup menu with Integrations

Step 2 — Enable API access

At the top of the integrations page, make sure Enable API Access for external applications is checked.

This must be checked first

With it unchecked, the token exists but is rejected, which looks like a bad credential rather than a disabled setting.

The integrations settings with API access enabled

Step 3 — Copy the API token

The API token shown on the integrations page

Step 4 — Connect in Mesh

Follow Connect your HR system, choose HR Partner in the connection window, and paste the token.

The connection window asking for the HR Partner API key

After connecting

The connector appears in your connectors list with Health: Initializing while the first collection runs, then moves to Good. Access is read-only: Mesh does not write back to HR Partner.

If it doesn't come online, see Troubleshoot HR connectors.

Troubleshooting

What you seeLikely causeFix
The token is rejectedEnable API Access for external applications is uncheckedCheck it, then reconnect with the same token
You cannot see the integrations pageThe account is not an HR Partner adminAsk an admin to retrieve the token