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

# Create a new sandbox account

`POST /sandbox/connections/accounts`

Create a new account for an existing connection (company/provider pair)

## Request body

- object
  - `company_id` string, uuid, required
  - `provider_id` string, required — The provider associated with the `access_token`
  - `authentication_type` 'api_token' | 'assisted' | 'credential' | 'oauth'
  - `products` string[] — Optional, defaults to Organization products (`company`, `directory`, `employment`, `individual`)

## Response `200`

OK

- object
  - `connection_id` string, uuid, required — The ID of the new connection
  - `entity_id` string, uuid, required — The ID of the entity for this connection
  - `company_id` string, uuid, required — The Finch UUID of the company associated with the `access_token`.
  - `provider_id` string, 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` 'api_token' | 'assisted' | 'credential' | 'oauth', required
  - `products` string[], required
  - `access_token` string, uuid, required

## Changes

> 53 revisions in range; 3 could not be searched.

- **2026-07-15** `4ffde1b7d987` — 1 info
  - response property `company_id` reactivated
- **2026-01-06** `ded87cb73aff` — 1 info
  - added the required property `entity_id` to the response with the `200` status
- **2025-06-24** `f7e741bc6e01` — 1 info
  - the endpoint scheme security `basicAuth` was added to the API

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/sandbox/connections/accounts/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/f1cca2cb0ef2/schema)