---
title: "Create"
method: POST
path: "/data-clips"
tags: ["data-clips"]
---

# Create

`POST /data-clips`

Creates a new DataClip.

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Request body

- TypeDataClipsCreateDataClipRequest
  - `name` string, required — The name of the DataClip.
  - `description` string — A description of the DataClip.
  - `sourceSheetId` string, required — Sheet ID
  - `collaborators` string[] — The list of collaborators.
  - `sharedLinkAccess` 'public' | 'restricted'

## Response `200`

Response with status 200

- TypeDataClipsDataClip
  - `id` string, required — Data Clip ID
  - `name` string, required — The name of the DataClip.
  - `description` string — A description of the DataClip.
  - `sourceSheetId` string, required — Sheet ID
  - `clipSheetId` string, required — Sheet ID
  - `workbookId` string, required — The ID of the workbook.
  - `status` string, required — The status of the DataClip.
  - `createdBy` string, required — The user who created the DataClip.
  - `mergedAt` string, date-time — The date when the DataClip was merged.
  - `deletedAt` string, date-time — The date when the DataClip was deleted.
  - `updatedAt` string, date-time, required — The date when the DataClip was updated.
  - `createdAt` string, date-time, required — The date when the DataClip was created.
  - `guestLinkUrl` string — A URL for guests to access the DataClip.
  - `accessToken` string — A signed token associated with the guest link.
  - `sharedLinkAccess` string — Indicates the shared link access level, public or restricted

## Other responses

- `400` — Error response with status 400
- `404` — Error response with status 404

---

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