PensionPro utilizes Locations to add an extra level of control over any data that is split between offices, branches, or regions, and to manage the contact information for each. The Firm represents the combination of all Locations. This article discusses managing details for the Firm and its individual Locations.
Settings for managing Firms and Locations can be found by navigating to Maintenance > Firms/Locations.
Tier Availability: Track, Team, Business
Security Rights Required: Maintenance
Article Contents
Defining Firms and Locations
PensionPro considers the Firm to be the business or company that offers plan administration services. This would be the single entity that oversees all data stored within PensionPro.
The Firm can—if desired—be broken out into multiple Locations. Each Location might represent one of the following:
- A physical office
- A geographic region
- A department or team
Much of the data stored within PensionPro—such as Client and Plan data—must be allocated to a Location upon its creation. This provides the following benefits:
- Records can be managed based on a Location's individual methods and practices
- Data can be grouped or filtered by Location for reporting purposes
- Access to data can be restricted based on the Locations an Employee is authorized to view
Employees are also associated with Locations. This is done in two distinct ways:
- An Employee must be assigned to at least one Location; this serves to better organize and visualize the Firm's structure. Instructions for managing Location assignments for Employees are provided later in this article.
- An Employee must have the permissions necessary to view records allocated to each Location. These permissions are called Location Rights, and are discussed in more detail in the article Location Rights.
This split provides greater flexibility in Location management, as Location Rights can be assigned independently of an Employee's actual working Location.
Firm Management
Most views on the Firm tab are used to manage details about the firm company, such as addresses, phone numbers, and company contacts. Details about these views can be found below.
General View
The General view contains basic firm information, such as the company's name. It also contains a number of items related to general PensionPro management for the firm:
-
Activity Logs: Options to export Activity, Audit, and Authentication logs for all users can be found in the More
menu at the top-right.
- API: Firm API key management for v1 of the API is found in this view. Refer to the section API Settings for more information.
- Tenant ID: This ID may be used to identify your firm's PensionPro account to third parties for integration purposes, such as when using External Payroll & Census Integration.
Contact Details
The Addresses, Numbers, and Contacts views function identically to those found on the Company tab, which manages contact information for any company known to the firm, whether they are a Client or simply the employer of a Contact. The information found in the article Managing Company Information is likewise applicable to these views.
Other Views
The following views contain more specific management options and are discussed elsewhere:
- Locations: See the Location Management section of this article, below.
- API Access & Webhooks: These views are specific to v2 of the API. Details can be found in the article PensionPro API.
Location Management
Tier Availability: Business
To view all of the firm's Locations, select the Locations view within the Firm tab. Each Location is listed within the grid; new Locations can be added by selecting Add to the top-right. Adding a new Location only requires a name that is unique from any existing Locations.
Hovering over any Location within the grid displays the Edit option on the right-hand side. The following details can be edited for each Location:
- The Location name
- The PlanSponsorLink Subdomain associated with the Location
- Whether the Location is the firm's default
- Whether the Location is marked for deletion
- Locations cannot be deleted instantly; instead, they must be marked for deletion, and then removed via Maintenance > Data Deletion.
Double-click a Location within the grid to open it in a new Location tab. This tab contains details specific to the Location, including address and phone number information and Employee management options.
Within the Location tab, the Addresses and Numbers views list the addresses and phone numbers associated with the Location. New addresses or numbers specific to the Location can be added by selecting Add to the top-right of the grid in each respective view. Addresses and numbers already associated with the Firm can be selected directly; alternately, new addresses and numbers can be created and added to both the Location and the Firm. Hover over an existing address or number within the grid to display the Edit
and Delete
options on the right-hand side.
The Directory view is used to determine which Employees are associated with the Location within the Company Directory. For more information, refer to the article Company Directory.
The Access view is used to manage Location Rights and assign them to Employees. For more information, refer to the article Location Rights.
API Settings
Tier Availability: Team, Business
For firms wishing to utilize the PensionPro API, the API Access and Webhooks views are used with the newest API release, v2. Full instructions for getting started and working with v2 can be found in the article PensionPro API.
The following instructions only pertain to v1, which will be deprecated on May 31, 2026:
An API key is required alongside any calls in order to verify the identity of the requestor. This key is unique to the firm, and can be found on the Firm tab > General view.
The API key is a critical component of data security, and is thus obscured by default. Select Show API Key to reveal the key and to allow it to be copied; select Hide API Key to obscure it again. The API Key should not be shared with any person who does not require it. In the event that the API key may be compromised, or for any other reason, it can be reset by selecting More > Regenerate API Key.