---
title: "Create a new connect session"
method: POST
path: "/connect/sessions"
tags: ["Connect"]
---

# Create a new connect session

`POST /connect/sessions`

Create a new connect session for an employer

## Headers

- `Finch-API-Version` string, date, required

## Request body

- object
  - `customer_id` string, required
  - `customer_name` string, required
  - `customer_email` string, email, nullable
  - `products` ConnectProducts[], required
  - `redirect_uri` string, nullable
  - `minutes_to_expire` number, nullable — The number of minutes until the session expires (defaults to 129,600, which is 90 days)
  - `sandbox` 'finch' | 'provider', nullable
  - `manual` boolean, nullable
  - `integration` object, nullable
    - `provider` string, nullable
    - `auth_method` 'assisted' | 'credential' | 'oauth' | 'api_token', nullable

## Response `201`

Created

- object
  - `session_id` string, required — The unique identifier for the created connect session
  - `connect_url` string, uri, required — The Connect URL to redirect the user to for authentication

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2025-06-24** `f7e741bc6e01` — 2 info
  - the endpoint scheme security `basicAuth` was added to the API
  - the `minutes_to_expire` request property's max was increased from `43200.00` to `129600.00`
- **2025-04-22** `a9dc15ba77c4` — 2 info
  - added the new `deduction` enum value to the request property `products/items/`
  - added the new `documents` enum value to the request property `products/items/`
- **2025-01-29** `9c0b41ca8713` — 1 breaking
  - the `minutes_to_expire` request property's max was decreased to `43200.00`

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/connect/sessions/post.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/6d0c6a1feba5/schema)