The Complete Namely Integration Guide (Never Copy-Paste HR Data Again)

Building a robust automation pipeline for Namely requires a few specific tools before you get started.

Think of this process like setting up a highly secure digital lockbox. Before you can seamlessly transfer your sensitive employee data, you need to configure the exact coordinates and cut the right keys.

To ensure a flawless setup, here is your essential integration checklist:

• Namely subdomain (acme → acme.namely.com) 

  
  

• Personal Access Token dedicated to Benefit Cloud 

  
  

• Scopes granted to the token (people.read, benefits.read, etc.) 

  
  

Gathering these three elements will make your technical connection feel incredibly straightforward.

Step 1: Confirm Admin Access

You cannot build the bridge if you are locked out of the control room.

Because HR data contains highly sensitive Personally Identifiable Information (PII), modern platforms like Namely operate with strict permission tiers. To execute this connection, you must be a Namely global admin with permission to view API tokens.

If you do not currently have this level of access, do not worry. Simply ask your Namely owner to grant you access.

Here is exactly how to verify your current permissions in the platform:

• From Namely, click your avatar.

  
  

• Navigate to Company → Roles.

  
  

• Verify your role includes the "Manage API Tokens" permission. If not, request it from your administrator.

  
  

Taking the time to confirm your administrative access right now will save you from hitting unnecessary roadblocks later in the process.

Step 2: Generate a Dedicated API Token

Now that you are in the control room, it is time to forge the digital key.

In the software world, this key is called a Personal Access Token (PAT). You will need to create a Personal Access Token (PAT) specifically for Benefit Cloud and limit it to the scopes we need.

Creating a dedicated token is a critical security best practice. It means you are giving Benefit Cloud a unique, trackable VIP pass that can be monitored or revoked without affecting any of your other software integrations.

Follow these precise steps to generate your token:

• Go to your profile menu → API → Personal Access Tokens → Create Token.

  
  

• Name the token "Benefit Cloud Integration".

  
  

• Select the minimum scopes: People (read), Benefits (read), Companies (read).

  
  

• Add others only if you want us to access them.

  
  

CRITICAL SECURITY WARNING: Once you hit save, you must act quickly. Save the token and copy the generated value immediately—Namely only shows it once.

If you navigate away from the page without copying that sequence of characters, it will be lost to the digital void, and you will be forced to generate an entirely new one.

Step 3: Share the Subdomain & Token Securely

You hold the key. You know your destination. Now, it is time to bring it all together.

Many professionals make the critical mistake of emailing their API credentials. Email is dangerously vulnerable to interception. Instead, you must use the interactive setup to send your Namely subdomain, API token, and optional notes to Benefit Cloud.

When you use our secure gateway, we encrypt and store the information right away. This guarantees your data is protected from end to end.

Here is how to finalize your automated connection:

• Provide the subdomain portion of your Namely URL (e.g., company.namely.com → company).

  
  

• Paste the token value (it begins with 'pat_').

  
  

• Let us know if Namely requires IP allow-listing or if you need us to limit calls to a sandbox.

  
  

Your subdomain acts as the exact GPS coordinate for your company's data, while the token opens the door. By alerting us to any IP restrictions, you ensure our servers can shake hands with yours without triggering any firewall alarms.

Ready to Transform Your HR Tech Stack?

The cost of delaying your automation strategy is measured in hours of your life you will never get back.

Every day you operate without the Benefit Cloud<>Namely integration is another day lost to tedious, robotic workflows. Don't let outdated manual processes hold your organization back from reaching its full potential.

You have the roadmap. The only thing left to do is log in and make it happen.

If you experience any technical friction, or if you simply want an expert to guide you through these three steps, we are standing by to assist you.