If your organization manages more than one company under a Paychex parent account, you don't need to set up a separate integration for each one. You can create a single app in the parent account, grant it access to each child company, and share one set of credentials with AirMason. Our Integrations team will then configure the connection for all of your selected companies.
If you only have one company in Paychex, follow How to Connect Paychex: HRIS Integration Setup instead.
Before You Begin
Make sure you have the following:
Super Admin or Security Admin permissions in the Paychex parent account. Standard Admin access is not enough to manage company access across accounts.
Admin or Owner access to your AirMason account. If you need to be added, see how to add a collaborator.
Part 1: Create the App in Your Parent Account
1. Log in to Paychex using the parent account and go to Company Settings.
2. Select Integrated Apps.
3. Click Create App.
4. Enter an Application Name (for example, AirMason) and a short Description.
5. Under access settings, select Read only for the Company and Worker APIs. You can leave the Payroll and check APIs switched off – AirMason only needs company and worker data.
6. Review and accept the Legal Notice and Paychex API License Agreement, then click Save.
7. Paychex will display your API Key and Client Secret. Copy both and keep them somewhere safe.
Part 2: Grant the App Access to Each Company
Still in the parent account, go to Company Settings → Integrated Apps and open the app you just created.
Scroll down to Company Access and click Add or Remove Company.
Select every company that should sync to AirMason using this set of credentials, then click Save.
Part 3: Turn On Access in Each Child Company
Adding a company in the parent account makes the app available, but each child company also needs to switch access on.
Use the company dropdown in the upper-left corner of Paychex to switch into the first child company.
Go to Company Settings → Integrated Apps and open the app.
Toggle Access on and click Save.
Repeat for every child company you selected in Part 2.
Part 4: Send Your Credentials to AirMason
Email integrations@airmason.com with the subject line Paychex Multi-Company Integration Setup - [Your Organization Name].
Include your API Key and Client Secret, the name of your AirMason account, and a list of the Paychex companies you enabled so we can confirm all of them are picked up.
Our team will configure the connector for all of your selected companies, confirm access, and let you know once the connection is live.
Security tip: API credentials grant access to your employee data, so treat them like a password. If your company uses a password manager or secure sharing tool (such as a one-time secret link), we recommend sending the credentials that way and letting us know in your email. If you prefer, reply to your email and our team can arrange a secure channel with you.
After the Connection Is Live
AirMason will sync employees from every company you enabled. You can review and manage them from the Manage Organization page in your AirMason admin dashboard, trigger a manual sync at any time, and assign handbooks to specific employees or groups.
Troubleshooting
If you don't see Company Access or Add or Remove Company, you are likely not a Super Admin or Security Admin in the parent account, or you created the app in a child account rather than the parent. Ask a Super Admin to help, or recreate the app from the parent account.
If employees from one company aren't appearing in AirMason, switch into that company in Paychex and confirm the app's Access toggle is on and saved.
If you add a new company to Paychex later, repeat Parts 2 and 3 for that company and email integrations@airmason.com so we can add it to your connection.
For anything else, reach out to integrations@airmason.com or support@airmason.com and we'll be happy to help.