Domain Guides
Authentication
Obtain scoped API tokens and manage the token lifecycle
Payroll
Create payroll runs, validate, approve, and track disbursement
Employer of Record
Onboard EOR employees, manage profiles and onboarding progress
Payslips
Generate, upload, and retrieve payslips with presigned download URLs
Webhooks
Subscribe to real-time events with HMAC-signed HTTPS delivery
Stablecoin Funding
Pre-fund payroll with on-chain stablecoin transfers
Integration Options
Toku supports three integration patterns depending on how deeply you want to embed its capabilities:- Embedded iframe: Render Toku’s hosted UI inside your product via iframe. Minimal engineering effort — drop in a frame and let Toku handle the UI.
- SSO redirect: Redirect authenticated users to Toku’s portal using SSO. Users experience Toku’s full interface under your authentication context.
- Headless API: Call Toku APIs directly and build your own UI. Full control over the user experience.
Use the headless API pattern when your platform needs full control over payroll and EOR UI while calling Toku APIs directly.
Getting Started
Create an API token
Call
POST /createUserAPIToken with your organization credentials to get a scoped bearer token.Configure webhooks
Register your HTTPS endpoint to receive real-time events for payroll, EOR, and payslip updates.
Run a test payroll
Create a draft payroll run with test employees to verify your integration end-to-end.
Quick Reference
| Domain | What it covers | Guide |
|---|---|---|
| Authentication | API token creation and refresh | Auth Guide |
| Payroll | Payroll run lifecycle: create → approve → disburse | Payroll Guide |
| Employer of Record | Employee onboarding, contracts, profile management | EOR Guide |
| Payslips | Payslip generation, upload, and download | Payslips Guide |
| Webhooks | Event delivery, signing, retry logic | Webhooks Guide |
| Stablecoin Funding | On-chain funding and settlement for payroll | Stablecoin Guide |
Rate Limits
All API endpoints are rate-limited to 100 requests per minute per IP address. Requests that exceed this limit receive a429 Too Many Requests response. See API Errors for error response formats.
Sandbox & Testing
Sandbox credentials are available on request. Contact Toku to provision a sandbox organization for integration testing before going live.
Ready to use Toku?
Embed Toku into your product
Add payroll, EOR, and stablecoin payment workflows without building compliance infrastructure.