The Complete PrismHR Integration Guide
- May 14
- 3 min read
For HR professionals managing PEO operations, the daily grind of manually exporting employee data and re-entering it into benefits systems is more than just tedious. It is a compliance risk hiding in plain sight. Every manual step is a chance for a typo, a missed enrollment, or a carrier discrepancy that only surfaces at the worst possible moment.
Connecting PrismHR to Benefit Cloud eliminates that cycle entirely. Once the integration is live, your employee data flows automatically from PrismHR into your benefits ecosystem, keeping carrier feeds accurate and your team focused on the work that actually matters.
PrismHR uses a Web Service User model for API access, which is different from the OAuth flows used by many other HRIS platforms. This guide walks you through the exact steps to set up that access and share it with Benefit Cloud securely. Most teams complete this in under an hour.
Ready to stop exporting data by hand? Here is what you need to do.
Step 1: Review PrismHR's Official Setup Documentation
Before you create any credentials, PrismHR recommends reviewing their official Web Service User documentation. This documentation explains how Web Service Users work within their system and what permissions they require.
Visit the PrismHR API documentation at: https://api-docs.prismhr.com
Navigate to the section on "Setting Up PrismHR and Web Service User Accounts."
Read through the documentation so you understand how WSU accounts function before you create one.
Step 2: Create a Dedicated Web Service User
Log into your PrismHR admin account and create a new Web Service User (WSU) specifically for the Benefit Cloud integration. Using a dedicated account keeps your integration isolated from any individual employee's login, so the connection never breaks if staff changes occur.
When setting up the Web Service User, use a name like "benefitCloud" to make it easy to identify.
Step 3: Configure API Permissions
The Web Service User needs specific API method permissions enabled. Configure the following Allowed Methods based on the data Benefit Cloud will need to sync.
Always required:
LoginService.createPeoSession
LoginService.getAPIPermissions
For company and client information:
ClientMasterService methods
For employee data:
EmployeeService methods
For payroll information:
PayrollService methods
Benefit Cloud will work with you to confirm the specific methods required based on your integration type. If you are unsure, leave a note in your credential submission and our team will follow up.
Step 4: Collect Your Credentials
Once your Web Service User is configured, gather the following information. You will need all of these to complete the secure submission in the next step.
User ID (for example: benefitCloud)
Password for the Web Service User account
PEO ID (your organization's numeric identifier in PrismHR)
Client ID and Name (for example: 321 - Your Company Name)
Step 5: Submit Credentials to Benefit Cloud
Share your credentials securely through the Benefit Cloud portal at app.benefitcloud.io/resources/guides/integrations/prismhr. All values are encrypted immediately on submission. Do not send credentials over unencrypted email.
Log into the Benefit Cloud portal.
Navigate to Resources and select the PrismHR Integration Guide.
Use the secure credential submission form to enter your User ID, Password, PEO ID, and Client ID.
Submit the form. Benefit Cloud will confirm receipt and begin testing the connection.
Step 6: Integration Complete
Once credentials are submitted, here is what happens next:
Benefit Cloud reviews the credentials and tests the connection to your PrismHR instance.
Our team configures the data mapping based on your specific feed requirements.
You receive confirmation once the integration is fully active.
Data will begin syncing automatically on your agreed schedule going forward.
Ready to automate your benefits data?
Book a demo to get started with Benefit Cloud today.