---
title: "Create a Data Feeds subscription"
method: POST
path: "/v1/subscriptions"
---

# Create a Data Feeds subscription

`POST /v1/subscriptions`

## Request

- Base URL: `https://api.ploti.ai`
- URL: `https://api.ploti.ai/v1/subscriptions`
- Auth: HTTP bearer

Receive every deliverable dataset in the named places, optionally only some topics, plus datasets named directly. Datasets that join later each send feed.dataset.added. The subscription belongs to the workspace.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string
  - `places` string[]: Place ids from list_feed_places. Every deliverable dataset in each place.
  - `topics` string[]: Only these topics within places, by the ids list_feed_topics gives. Every topic when left out.
  - `datasetIds` string[]: Datasets to include on their own, from any place in the coverage.

## Response `201`

Created

- object
  - `id` string, required
  - `name` string, required
  - `places` string[], required
  - `topics` string[], required
  - `datasetIds` string[], required
  - `revision` integer, required: Send it back as If-Match (or revision) to update.
  - `datasetCount` integer, required
  - `lastEventCursor` string, nullable, required
  - `createdAt` string, required

## Other responses

- `401`: The credential is missing or not valid.
- `413`: payload_too_large: the body is over 256 KB (2 MB for /v1/tools).
- `415`: unsupported_media_type: a body was sent without Content-Type: application/json.
- `429`: rate_limited: this credential is over its rate. Retry after the Retry-After header's seconds.
- `500`: internal: Ploti failed. Retry; if it keeps happening, contact support.
- `default`: Refused: nothing was done. The code says why and the links say where the person acts on it.

---

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