---
title: "Add Dataframe"
method: POST
path: "/v1/accounts/{account_id}/environments/{environment_id}/dataframes"
tags: ["Dataframes"]
---

# Add Dataframe

`POST /v1/accounts/{account_id}/environments/{environment_id}/dataframes`

**Authorization scope:** `dataframe:write` 
 
 **Creates a new dataframe entity.**
****
**Please note that the Dataframe's name has to be unique**

## Path parameters

- `account_id` string, required
- `environment_id` string, required

## Request body

- DataframeAddInput — Input for adding Dataframe
  - `connection_settings` DataframeConnectionSettingsInput — Input for the Dataframe connection settings
    - `connection` string, required — The connection of the connection_settings
    - `datasource_id` string, required — The datasource_id of the connection_settings
    - `default_bucket` string, required — The default bucket of the connection settings
    - `storage_type` string, required — The storage type of the connection settings
  - `name` string, required — The name of the dataframe - must be unique

## Response `201`

Successful Response

- DataframeResponse — Dataframe response properties to return
  - `account_id` string, required — The account id of the user
  - `environment_id` string, required — The environment id of the user
  - `connection_settings` object — The connection settings of the dataframe
  - `name` string, required — The name of the dataframe - must be unique

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivery/apis/boomi-data-integration-api.md) · [All operations](https://skmtc.net/rivery/apis/boomi-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivery/boomi-data-integration-api/revisions/34b100db5131/schema)