HRIS · Beta
PayCaptain
API integration
Ship HRIS features without building the integration. Full PayCaptain API access via Proxy and 5 MCP-ready tools for AI agents — extend models and mappings to fit your product.
Built for specific customer use cases. Issues are resolved quickly.
Talk to usUse Cases
Why integrate with PayCaptain
Common scenarios for SaaS companies building PayCaptain integrations for their customers.
Automate HR-to-Payroll Employee Provisioning
Global HRIS and onboarding platforms can push new hire records directly into PayCaptain the moment they're created, eliminating dual data entry for mutual UK customers running payroll in a separate system.
Push Approved Shifts from WFM into Payroll
Workforce management and scheduling SaaS can send finalized shift and hours data straight into PayCaptain at the end of each pay period, so hospitality and retail customers no longer upload CSVs on payroll day.
Inject Tips and Variable Earnings into Pay Runs
Cashless tipping, tronc, and bonus distribution platforms can write ad-hoc payments directly into PayCaptain, ensuring variable earnings flow into the correct employee's upcoming pay run without manual reconciliation.
Verify Income for Earned Wage Access and Lending
Financial wellbeing, EWA, and employee lending apps can pull high-fidelity payslip data to verify employment, analyze YTD earnings, and calculate safe advance or loan amounts for UK employees.
Build a Unified HR-Payroll Record for Finance Teams
Finance and spend management platforms can reconcile headcount and payslip output against GL entries by syncing employee records and payslip line items from PayCaptain into their own data model.
What You Can Build
Ship these features with Truto + PayCaptain
Concrete product features your team can ship faster by leveraging Truto’s PayCaptain integration instead of building from scratch.
New Hire Auto-Provisioning to PayCaptain
Trigger create_a_pay_captain_employee from your onboarding flow so new UK employees are instantly ready for payroll processing without HR logging into a second system.
End-of-Period Shift Sync
Loop through approved timesheets and call create_a_pay_captain_shift to push exact hours worked into PayCaptain before each pay run cutoff.
Tips and Bonus Payment Injection
Use create_a_pay_captain_payment to deliver tronc distributions, commissions, or one-off bonuses into the next PayCaptain pay cycle automatically.
Payslip-Backed Income Verification
Pull list_all_pay_captain_payslips to extract YTD earnings and deduction line items for underwriting salary advances or verifying employment inside your fintech product.
Employee Directory Reconciliation
Use list_all_pay_captain_employees to continuously reconcile your HRIS roster against PayCaptain and surface mismatches before they cause payroll errors.
Payroll-Ready Dashboard for HR Admins
Combine employee and payslip reads to show mutual customers a single view of who is provisioned, who has been paid, and what hours still need to be submitted.
SuperAI
PayCaptain AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
list_all_pay_captain_employees
Get employees, paginated at 50 records per page. Returns: company, hrEmployeeId, payrollCode, firstName, middleName, lastName, dateOfBirth, gender. Optional filters: lastModifiedDate, includeFormer. company comes from the connected credential.
create_a_pay_captain_employee
Create or update an employee.
list_all_pay_captain_payslips
Get all payslips and payslip lines for one pay period, paginated at 50 records per page. Returns: payslip, employee, totals, ytd, previousEmployment, thisEmployment, payslipLines. Required: payPeriod. No PayCaptain endpoint enumerates valid pay periods, so that value must come from out of band. company comes from the connected credential.
create_a_pay_captain_shift
Create, update, or archive a shift in PayCaptain by submitting the shift dataset as a JSON request body. Returns a success response with no documented response body content.
create_a_pay_captain_payment
Create, update, or archive a payment in PayCaptain by submitting the payment dataset. Returns a 200 Success response with no documented response body.
Why Truto
Why use Truto’s MCP server for PayCaptain
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 800+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
How It Works
From zero to integrated
Go live with PayCaptain in under an hour. No boilerplate, no maintenance burden.
Link your customer’s PayCaptain account
Use Truto’s frontend SDK to connect your customer’s PayCaptain account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call PayCaptain
Truto’s Proxy API is a 1-to-1 mapping of the PayCaptain API. You call us, we call PayCaptain, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate PayCaptain’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about PayCaptain on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
What operations does the PayCaptain integration support today?
Through Truto you can list employees, create employees, list payslips, create shifts, and create payments. Any additional PayCaptain endpoints can be added on request.
Is PayCaptain available via a Unified API in Truto?
Not yet. PayCaptain is currently accessed through its native tools in Truto. You can still normalize data in your own layer, or request inclusion in Truto's HRIS Unified API.
How do end users authenticate their PayCaptain account?
End users connect their PayCaptain account through Truto's hosted auth flow. Truto manages credential storage, refresh, and secure proxying of requests, so you never handle PayCaptain secrets directly.
Can I retrieve payslips for a specific pay period?
Yes, but the PayCaptain API does not enumerate valid pay periods. Your integration must capture the desired payPeriod value out-of-band (for example, from the customer or from a prior sync) before calling list_all_pay_captain_payslips.
How does Truto handle pagination and rate limits for PayCaptain?
Truto normalizes pagination across list endpoints and transparently handles retries and backoff when PayCaptain rate limits are hit, so you receive complete result sets without writing provider-specific logic.
Can I push hours and ad-hoc payments in bulk for a pay run?
Yes. You can iterate over your source data and call create_a_pay_captain_shift and create_a_pay_captain_payment per record to assemble a full pay run programmatically, replacing manual CSV uploads for mutual customers.
PayCaptain
Get PayCaptain integrated into your app
Our team understands what it takes to make a PayCaptain integration successful. A short, crisp 30 minute call with folks who understand the problem.