Connect HURMA to Match Employees with Clients

HURMA is a Ukrainian HR system. When connected, PaperLink fetches your active employee list and matches each employee to a client in your team. Mapped employees speed up document creation - name, email, and contact details fill in automatically.

Before You Start: Create an API Client in HURMA

PaperLink connects to your HURMA workspace via OAuth 2.0. Each HURMA account must create its own API client - there is no shared app to install.

1. Open your HURMA admin panel and go to Settings > API > Add API client.
2. Set a title (for example, PaperLink).
3. Set Authorization type to Authorization code.
4. Enter the redirect URL: https://app.paperlink.online/api/hurma/callback
5. Under scopes, enable at least Employees: Read.
6. Save. HURMA generates a Client ID and a Client Secret - copy both.

Connect Your HURMA Workspace

1. Go to Settings in the left sidebar and click Integrations.
2. Find the HURMA card and click Connect HURMA.
3. On the connection form, fill in three fields:
   • HURMA domain - your workspace URL, for example yourcompany.hurma.work
   • Client ID - the integer ID from the HURMA API client you created
   • Client Secret - the secret string from the same API client
4. Click Connect HURMA.

PaperLink redirects you to the HURMA authorization page. Log in and approve access. After approval, HURMA sends you back to PaperLink automatically.

On return, PaperLink fetches your active employee list and opens the employee mapping table.

Map Employees to Clients

The mapping table shows every active employee from HURMA. For each employee, you choose which PaperLink client they correspond to.

PaperLink tries to match automatically: if an employee's email matches a client email in your team, the mapping is pre-filled and marked Auto-matched by email.

For employees without a match, you have two options:

• Select an existing client from the dropdown in the PaperLink Client column.
• Create a new client inline - the form pre-fills name and email from the HURMA employee record.

When you are done, click Save Mappings. The counter at the top shows how many employees are mapped and how many are still unmapped.

Keep the List Current

When new employees join your HURMA account, click Sync Employees on the connected HURMA page. PaperLink fetches the latest active list and adds new employees as Unmapped - existing mappings are not changed.

Employees who left your company are not deleted from the mapping table. They appear as Inactive and are excluded from document auto-fill.

Disconnect HURMA

1. Open Settings > Integrations and go to the HURMA page.
2. Click Disconnect HURMA and confirm.

Disconnecting removes the OAuth tokens. Your employee mappings are preserved - if you reconnect later, you do not need to remap everyone from scratch.

Reconnect or Switch Accounts

If your HURMA session expires, the page shows Reconnection Required with a Reconnect HURMA button. Click it and complete the OAuth flow again. Existing mappings are preserved.

To switch to a different HURMA workspace, click Connect HURMA from the integrations page and enter the new credentials. The old tokens are replaced and a fresh employee sync runs.

Related

• PaperLink Now Connects to HURMA - feature overview with use cases and how the integration works
• Connect Slack for Real-Time Notifications - get notified in Slack when someone views or downloads your documents
• Connect to the PaperLink Public API - automate workflows with external tools using REST API keys
• Invite a Team Member - manage who has OWNER and ADMIN access on your team