Skip to main content
A Personal Access Token is created under the API menu of your Namely HRIS site. Use a token from an Administrator user (ideally a dedicated integrations profile) so it is not tied to an individual employee.

​
Finding your Namely subdomain

Your subdomain identifies your Namely site.

1

Locate your subdomain

Your subdomain is the text before .namely.com in your Namely URL. For example, if you access Namely at https://acme.namely.com, your subdomain is acme.

​
Create a Personal Access Token

Generate a Personal Access Token to authenticate API requests.

1

Open the API menu

Sign in to your Namely HRIS site as an administrator and click the API menu item. If you do not see it, contact your client success manager or Namely administrator for permission.

2

Create the token

On the Personal Access Tokens tab, click New Access Token, give it a name for future reference, and click Create.

3

Copy the token

Copy and store the token securely - it is only shown once.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Subdomain
  • Personal Access Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup
If the account linking is successful, you will see the newly linked account in your Accounts page.