DOdovetail
Datasets

Create data point on a dataset

Changed on

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

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

Path parameters

dataset_idstring required

Unique identifier of the dataset, shown as a dataset under its source in Dovetail. Accepts the short form shown in the UI or the plain uuid.

Request body

textstring required

The data point's content, used to analyze and classify the data point.

timestampstring required

The data point's timestamp in ISO8601 format.

source_titlestring

The title of the original source from which this data point was extracted.

source_urlstring

The URL of the original source from which this data point was extracted.

emailstring 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.

metadataobject

Optional key-value metadata to be included with the data point.

Example request

{
  "text": "Support email requesting a trial for Dovetail app.",
  "email": "jane@example.com"
}

Response

201

Changes