---
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

- CreateConnectSessionRequest
  - `customer_id` string, required — Unique identifier for the customer
  - `customer_name` string, required — Name of the customer
  - `customer_email` string, email, nullable — Email address of the customer
  - `products` ConnectProducts[], required — The Finch products to request access to. Use `benefits` to access deductions endpoints — `deduction` is a deprecated alias that is still accepted but should not be combined with `benefits`.
  - `redirect_uri` string, nullable — The URI to redirect to after the Connect flow is completed
  - `minutes_to_expire` number, nullable — The number of minutes until the session expires (defaults to 129,600, which is 90 days)
  - `sandbox` 'finch' | 'provider' | 'null', nullable — Sandbox mode for testing
  - `manual` boolean, nullable — Enable manual authentication mode
  - `integration` object, nullable — Integration configuration for the connect session
    - `provider` string, required — The provider to integrate with
    - `auth_method` 'assisted' | 'credential' | 'oauth' | 'api_token' | 'null', nullable — The authentication method to use

## Response `201`

Created

- CreateConnectSessionResponse
  - `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

---

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