SMB Payroll Dashboard
Payroll Overview
Manage your team's payroll, view upcoming runs, and track payments — all in one place.
Active Employees
24
↑ 3 this month
Next Payroll
$41,280
Due Mar 15, 2026
YTD Payroll Runs
5
All completed
Tax Filings
Current
↑ CostSavings handled
Upcoming Payroll Run
Semi-monthly · Mar 15, 2026 · 24 workers
Data collection complete
87%
TOTAL GROSS
$41,280.00
TAXES
$10,832.40
NET PAY
$30,447.60
Recent Payroll Runs
| Pay Period | Run Date | Employees | Total | Status |
|---|---|---|---|---|
| Mar 1–15 | Mar 15, 2026 | 24 | $41,280 | Pending |
| Feb 15–28 | Feb 28, 2026 | 23 | $39,820 | Completed |
| Feb 1–14 | Feb 15, 2026 | 23 | $39,820 | Completed |
| Jan 15–31 | Jan 31, 2026 | 21 | $36,540 | Completed |
| Jan 1–14 | Jan 15, 2026 | 21 | $36,540 | Completed |
CostSavings Express Embed
Employer & Worker Onboarding
Seamlessly onboard new businesses and their employees using CostSavings's embeddable UI components.
Employer Setup Wizard
CostSavings Express · CostSavings.elements.create('employer-onboarding')
CostSavings.JS EMBED
🏢
Business Information
Complete your business setup to start running payroll.
Setup Checklist
3 of 5 steps complete
✓
Business Information
Legal name, EIN, address, and state registered
Complete
✓
Bank Account Linked
Funding account connected via CostSavings KYB flow
Complete
✓
Pay Structure Defined
Salary & hourly rates configured via Paystream API
Complete
4
Worker Onboarding
Invite workers to complete their profile via CostSavings hosted link
In Progress
5
First Payroll Run
Run your first payroll after all workers have onboarded
Pending
Worker Onboarding Status
| Name | Role | Invited | Onboarding Status | Action |
|---|---|---|---|---|
| Sarah Johnson | Engineer | Feb 12 | Complete | |
| Marcus Chen | Designer | Feb 18 | Complete | |
| Priya Patel | Sales Manager | Mar 1 | In Progress | |
| Tom Rodriguez | Operations | Mar 3 | Invited |
Paystream API
Run Payroll
Import pay data via Paystream API and run compliant payroll with one click.
Import Pay Entries via Paystream API
POST /api/rest/v1/paystream
// Paystream — Import pay entries for current pay period
curl --location 'https://api.CostSavings.dev/api/rest/v1/paystream' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--data '{
"data": [
{
"type": "PaystreamPayEntryUpsertInput",
"workerId": "wkr_sarah_johnson_id",
"payReferenceId": "ref:pay:costsavings:us:salary",
"startDate": "2026-03-01",
"endDate": "2026-03-15",
"amount": "3750.00"
},
{
"type": "PaystreamPayEntryUpsertInput",
"workerId": "wkr_marcus_chen_id",
"payReferenceId": "ref:pay:costsavings:us:hourly",
"startDate": "2026-03-01",
"endDate": "2026-03-15",
"hours": "80",
"rate": "45.00"
}
]
}'
Employer Dashboard
CostSavings Express · CostSavings.elements.create('employer-dashboard')
CostSavings.JS EMBED — EMPLOYER DASHBOARD
Mar 1–15, 2026 Payroll
Awaiting Confirmation| Worker | Type | Hours / Amount | Gross Pay | Status |
|---|---|---|---|---|
| Sarah Johnson | Salary | $3,750.00 | $3,750.00 | Ready |
| Marcus Chen | Hourly | 80 hrs @ $45 | $3,600.00 | Ready |
| Priya Patel | Salary | $4,200.00 | $4,200.00 | Ready |
| Tom Rodriguez | Hourly | 76 hrs @ $38 | $2,888.00 | Onboarding |
24 workers · $41,280.00 gross
Worker Payments List
CostSavings Express · CostSavings.elements.create('worker-payments-list')
CostSavings.JS EMBED — WORKER PAYMENTS LIST
| Worker | Pay Period | Gross | Tax Withheld | Net Pay | Method |
|---|---|---|---|---|---|
| Sarah Johnson | Feb 15–28 | $3,750.00 | $982.50 | $2,767.50 | Direct Deposit |
| Marcus Chen | Feb 15–28 | $3,450.00 | $905.12 | $2,544.88 | Direct Deposit |
| Priya Patel | Feb 15–28 | $4,200.00 | $1,101.00 | $3,099.00 | Direct Deposit |
Paystream API — Workers
Worker Management
Add, view, and manage workers. Sync your CostSavings platform data to CostSavings via the Paystream API.
Add Worker via Paystream
POST /api/rest/v1/paystream/workers
Worker Profile
CostSavings.elements.create('worker-profile')
CostSavings.JS EMBED
SJ
Sarah Johnson
Software Engineer · Salaried
WORKER ID
wkr_sj_8b3c1d
ANNUAL SALARY
$90,000.00
STATE
California
STATUS
Active
All Workers (24)
| Name | Worker ID | Type | Rate | State | Onboarding | |
|---|---|---|---|---|---|---|
| Sarah Johnson | wkr_sj_8b3c | Salary | $90k/yr | CA | Done | |
| Marcus Chen | wkr_mc_2d4e | Hourly | $45/hr | CA | Done | |
| Priya Patel | wkr_pp_5f6g | Salary | $100.8k/yr | TX | In Progress | |
| Tom Rodriguez | wkr_tr_7h8i | Hourly | $38/hr | FL | Invited | |
| + 20 more workers · Load all from CostSavings API → | ||||||
Integration Reference
API Integrations & Webhooks
Everything CostSavings uses to power payroll — CostSavings's REST APIs, GraphQL, and real-time webhooks.
Paystream — Employers
Import and sync employer data from your CostSavings platform into CostSavings when a business signs up for payroll.
POST /paystream/employers
Paystream — Workers
Batch import worker records directly from your HR data into CostSavings. Supports both salaried and hourly employees.
POST /paystream/workers
Paystream — Pay Entries
Send compensation data (hours, salary, bonuses) per pay period to auto-populate payroll runs and reduce manual input.
POST /paystream
Credentials API
Generate short-lived User Tokens (OAuth 2.0) for employer admins and workers with role-based access control.
POST /auth/token
CostSavings.js Components
Embed employer onboarding, employer dashboard, worker profile, and payments list directly into the CostSavings UI.
CostSavings.elements.create()
GraphQL API
Advanced use cases — build fully custom payroll experiences using CostSavings's flexible GraphQL API for deeper data access.
api.CostSavings.dev/graphql
Authentication — User Token Generation
POST /api/rest/v1/auth/token · OAuth 2.0 Bearer
// Step 1: Generate a User Token for an employer admin session
curl --request POST \
--url 'https://api.sandbox.CostSavings.dev/api/rest/v1/auth/token' \
--header 'Authorization: Bearer YOUR_SANDBOX_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"type": "CreateEmployerUserTokenInput",
"role": "EMPLOYER_ADMIN",
"employerIds": ["emp_8a7b2c"]
}'
// Step 2: Use the token to initialize the CostSavings.js SDK
const CostSavings = window.CostSavings('cs-public-client-key', { env: 'sandbox' });
// Step 3: Embed the Employer Dashboard
const element = CostSavings.elements.create('employer-dashboard', { token: userToken });
CostSavings.elements.mount(element, '#CostSavings-container');
Webhook Event Listeners
Real-time notifications for payroll events
PayrollRun.awaitingInput
Triggers when compensation data is needed — CostSavings pushes pay entries via Paystream
Worker.onboardingStatus
Fires when a worker is invited, starts, or completes onboarding — used to update CostSavings records
Notification.employerPaydayReminder
Triggers 2 days before payroll confirmation deadline — CostSavings sends reminders to employers
Notification.employerPayrollRunConfirmation
Fires when employer confirms a run — triggers CostSavings confirmation email
Notification.workerPayday
Fires on payday — CostSavings sends workers a pay notification and links to their pay stub