---
title: "Create a new Sandbox Connection"
method: POST
path: "/sandbox/connections"
tags: ["Sandbox"]
---

# Create a new Sandbox Connection

`POST /sandbox/connections`

Create a new connection (new company/provider pair) with a new account

## Request body

- object
  - `provider_id` string, required — The provider associated with the connection
  - `authentication_type` 'credential' | 'api_token' | 'oauth' | 'assisted'
  - `products` string[]
  - `employee_size` integer — Optional: the size of the employer to be created with this connection. Defaults to 20. Note that if this is higher than 100, historical payroll data will not be generated, and instead only one pay period will be created.

## Response `200`

OK

- object
  - `connection_id` string, uuid, required — The ID of the new connection
  - `company_id` string, uuid, required — [DEPRECATED] Use `connection_id` to associate a connection with an access token
  - `provider_id` string, uuid, required — The ID of the provider associated with the `access_token`.
  - `account_id` string, uuid, required — [DEPRECATED] Use `connection_id` to associate a connection with an access token
  - `authentication_type` 'credential' | 'api_token' | 'oauth' | 'assisted', required
  - `products` string[], required
  - `access_token` string, uuid, required
  - `token_type` string

---

[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/57fcc886b059/schema)