# Get Vestwell State Savings contributions through an API

> Read your contribution history, savings rate changes and employee statuses from the Vestwell State Savings employer portal with one API call each. A workflow can check the rate changes every weekday morning and email you whose rate to update before payroll.

Page: https://fous.com/automate/vestwell-state-savings-employer-portal
Updated: 2026-11-12

Works with your own Vestwell State Savings employer portal account. Fous is an independent product.

## What you can build on the employer portal

### Get contribution history

Reads the History section of the Contributions page: each submission's transaction date, type, pay group and status.

- Takes: Time range, pay group (optional), transaction type (optional)
- Returns: Transaction date, transaction type, pay group, status

### Get savings rate changes

Opens View Savings Rate Changes on the Contributions page and reads which employees changed their savings rate and their new rate.

- Takes: Nothing
- Returns: Employee name, new savings rate, next pay date

### Get the employee list

Reads the Employees page, filtered by status: Pending, Ineligible, Active or Opted Out.

- Takes: Status (optional)
- Returns: Employee name, status, employment status

### Add a new employee

Opens Add Employee on the Employees page, fills in the required fields and saves the new employee.

- Takes: First name, last name, SSN, birthdate, address, state, ZIP code, email or phone number
- Returns: Employee name, status

## Automate the employer portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Savings rate changes, before each payroll

Starts: Every weekday at 7:00

1. Get the savings rate changes on the Contributions page.
2. Stop when the list is empty, and keep the changes that were not there on the last run.
3. Email you each employee's name and new savings rate, with the Next Pay Date.

### Missing and unfinished contribution submissions

Starts: Every Monday at 8:00

1. Get the contribution history for the last 60 days.
2. Keep the transactions in Missing or Submission Started status.
3. Post each one, with its date, pay group and status, to your payroll team's Slack webhook.

### Employee status changes, to your HR system

Starts: On the 1st of every month at 9:00

1. Get the employee list with every status.
2. Keep the employees whose status changed since the last run, such as Pending to Active or Opted Out.
3. Post name, old status and new status to your HR system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get contribution history” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "signin.vestwell.com/get_contribution_history",
    "input": {
      "from": "2026-09-01",
      "to": "2026-11-11",
      "pay_group": "Biweekly"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "transactions": [
      {
        "transaction_date": "2026-11-06",
        "transaction_type": "Contributions",
        "pay_group": "Biweekly",
        "status": "Completed"
      }
    ]
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The employer portal’s own options

The employer help centre describes payroll integrations and file uploads, not an employer API. Where your payroll provider integrates, contributions arrive each pay period on the scheduled pay date, but integrations are not available for every provider. Otherwise you upload an Excel or CSV file or enter contributions in the portal.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Payroll integration | Your provider sends contributions each pay period on the scheduled pay date. Some, such as QuickBooks Online and Paylocity, also send savings rate changes back. | A payroll provider with an integration. For TPI Pay, the help centre says the state program does not charge for it. |
| Contribution file upload | Sends one pay group's contributions from an Excel or CSV file, checked with Send & Validate before you complete the submission. | Columns for SSN, first name, last name and Savings $ Amount, matching the Employees page. Other columns are ignored. |
| Employee list download | Download Report on the Employees page, filtered by status. | Excel or CSV, chosen from the drop-down. |
| The employer portal by hand | The Contributions page with Next Pay Date, savings rate changes and History, and the Employees page. | An administrator account. Other administrators are invited by email. |

Read on November 12, 2026: [How to Submit Contributions via File Upload](https://help.oregonsaves.com/hc/en-us/articles/27654316973975-How-to-Submit-Contributions-via-File-Upload), [Understanding Your Contributions Dashboard](https://help.oregonsaves.com/hc/en-us/articles/27655450815895), [Payroll integration articles](https://help.oregonsaves.com/hc/en-us/articles/27924588027287).

## Signing in to the employer portal

You sign in from your program's home page with your email address and password. Two-factor authentication is optional; when you add it, the 6-digit code comes from an authenticator app or by text message or voice call. With Fous you sign in once through the portal's own sign-in with your own account, and the login is sealed with AES-256. On a password-only account, an expired session is signed back in.

## Worth knowing

- **Rate changes post the next business day**: Savings rate changes appear on the portal the following business day. The reminder email about four days before payroll comes only if you gave a payroll schedule, so otherwise check before each pay period.
- **Missing after seven business days**: A submission not made becomes Missing seven business days after its due date. Processing usually lasts about one business hour, and a Processing submission can still be cancelled.
- **One submission per pay group**: If you have more than one pay group, each is submitted separately. Employee data in an uploaded file must match the Employees page, and errors in red block the submission until fixed.
- **Integrated changes lag a pay date**: With a payroll integration, roster and status changes show in the portal 1 to 2 business days after the next pay date.

## More in Government: US state employer and business filings

- [bizfile Online](https://fous.com/automate/bizfile-online.md)
- [SOSPortal](https://fous.com/automate/sosportal.md)
- [Sunbiz](https://fous.com/automate/sunbiz.md)
- [DIR Public Works eCPR](https://fous.com/automate/dir-public-works-ecpr.md)
- [CalSavers](https://fous.com/automate/calsavers.md)
- [SIDES E-Response](https://fous.com/automate/sides-e-response.md)
- [EAMS (Washington ESD)](https://fous.com/automate/eams-washington-esd.md)
- [GDOL Employer Portal](https://fous.com/automate/gdol-employer-portal.md)
- [MiUI Employer Portal](https://fous.com/automate/miui-employer-portal.md)
- [myEDD e-Services for Business](https://fous.com/automate/myedd-e-services-for-business.md)
- [NCSUITS](https://fous.com/automate/ncsuits.md)
- [NYS DOL Unemployment Services for employers](https://fous.com/automate/nys-dol-unemployment-services-for-employers.md)
- [The SOURCE](https://fous.com/automate/the-source.md)
- [UCMS](https://fous.com/automate/ucms.md)
- [Unemployment Services for Employers](https://fous.com/automate/unemployment-services-for-employers.md)

Other industries: [京东企业购](/automate/jd-enterprise), [Magnit VMS](/automate/magnit-vms), [340B OPAIS](/automate/340b-opais), [HealthSherpa](/automate/healthsherpa), [Authorized Paid Representative Portal](/automate/authorized-paid-representative-portal), [CARM Client Portal](/automate/carm-client-portal).

## Frequently asked questions

### Does the Vestwell State Savings employer portal have an API?

Not one the employer help centre describes. Employers whose payroll provider has an integration get contributions sent each pay period, though integrations are not available for every provider. Everyone else uploads an Excel or CSV file or enters contributions in the portal, and can download the employee list as Excel or CSV.

### How do I see which employees changed their savings rate?

Select View Savings Rate Changes on the Contributions page. It lists each employee with a new rate. After updating payroll, tick each employee and select Mark as Complete, which stops the reminders.

### What does a contribution upload file need?

An Excel or CSV file with columns for SSN (with or without dashes), first name and last name in separate columns, and Savings $ Amount. Other columns are ignored, and you can map your own headers to the required fields before Send & Validate.

### Can someone else in my company use the portal?

Yes. Enter a team member's email address and select Send Email Invite. Once their status shows Registered they can act as an administrator. Invitations expire after 20 days.

### Is Fous affiliated with Vestwell?

No. Fous is an independent product. You use it with your own employer portal account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Vestwell State Savings employer portal (Vestwell). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.