---
title: "Create data point on a dataset"
method: POST
path: "/v1/dataset/{dataset_id}/data"
tags: ["Datasets"]
---

# Create data point on a dataset

`POST /v1/dataset/{dataset_id}/data`

## Request

- Base URL: `https://dovetail.com/api`
- URL: `https://dovetail.com/api/v1/dataset/{dataset_id}/data`
- Auth: HTTP bearer

Send a new data point to a dataset, without it having to belong to a channel.

A dataset is one connection under a source — the same thing shown as a dataset in the Dovetail UI. Sending data here lets a push-based source (such as the API or Zapier) ingest before any channel subscribes to it. Field values are captured against the source as the data arrives, so once a channel does subscribe, the data is already filterable.

No `url` is returned. Until a channel subscribes to the source, the data point has no page in Dovetail to link to.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

**Required scope:** `channel:write`

## Path parameters

- `dataset_id` string, required

## Request body

- object
  - `text` string, required: The data point's content, used to analyze and classify the data point.
  - `timestamp` string, required: The data point's timestamp in ISO8601 format.
  - `source_title` string: The title of the original source from which this data point was extracted.
  - `source_url` string: The URL of the original source from which this data point was extracted.
  - `email` string, email: Email of the person this data point is from. When the source creates contacts, the data point is linked to that contact, creating it if needed. Returns 400 if invalid.
  - `metadata` object: Optional key-value metadata to be included with the data point.

## Response `201`

201

- object
  - `data` object, required
    - `id` string, required: Unique identifier of the data point.
    - `dataset` object, required
      - `id` string, required: Unique identifier of the dataset.
    - `timestamp` string, required: The data point's timestamp in ISO8601 format.
    - `created_at` string, required: When the data point was created, in ISO8601 format.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `422`: 422
- `429`: 429
- `500`: 500

## Changes

- **2026-11-03** `8abea327e6b9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dovetail/apis/dovetail-public-api/changes/v1/dataset/:dataset_id/data/post.md)

---

[API](https://skmtc.dev/dovetail/apis/dovetail-public-api.md) - [All operations](https://skmtc.dev/dovetail/apis/dovetail-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dovetail/apis/dovetail-public-api/revisions/8abea327e6b9?raw)