---
title: "Connect Account"
method: POST
path: "/accounts/connect"
---

# Connect Account

`POST /accounts/connect`

Returns a hosted connection URL, which allows the user to connect to a specific account in the state agency such as accessing Employer Services Online Account in California Employment Development Department. This endpoint returns the connection_id which can be used to query the current status of the connection.

## Request body

- PlatformConnectRequest
  - `legal_entity_id` string, required
  - `agency_account_id` string, required

## Response `200`

Successful Response

- PlatformConnectSession
  - `connect_url` string, required
  - `connection` PlatformConnection, required
    - `id` string, required
    - `status` 'pending' | 'authenticating' | 'registering' | 'connected' | 'disconnected' | 'canceled', required
    - `account` PlatformAccount, required
      - `id` string, required
      - `agency_account` AppApiPlatformAccountsModelsPlatformAgencyAccount, required
        - `id` string, required
        - `agency_id` string, required
        - `region` string, required
        - `name` string, required
      - `status` 'active' | 'exception' | 'closed', required
      - `id_number` string, required
      - `has_tpa` boolean, required
      - `tax_rate_percent` number, nullable
      - `reporting_schedule` string, nullable
      - `balance` integer, nullable
      - `history` PlatformAccountHistoryItem[], nullable
        - `period_start_date` string, date, required
        - `period_end_date` string, date, required
        - `payment_date` string, date, required
        - `filing_date` string, date, required
        - `payment_amount` integer, required
        - `amount_due` integer, required
        - `amount_applied` integer, required
        - `raw_data` object, required
      - `notices` PlatformAccountNotice[], nullable
        - `mail_classification` 'penalty' | 'underpayment' | 'tax_rate_change' | 'other', required
        - `received_on` string, date, required
        - `description` string, required
        - `summary` string, required
        - `signed_url` string, required
      - `account_login` PlatformAccountLogin
        - `login_url` string, required
        - `user_name` string, required
        - `two_factor_enabled` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mosey/apis/mosey-api.md) · [All operations](https://skmtc.net/mosey/apis/mosey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mosey/mosey-api/revisions/2121b0e65643/schema)