---
title: "Creates a subscription to a block for a user. The user will receive change notifications for the block."
method: POST
path: "/api/v1/subscriptions"
---

# Creates a subscription to a block for a user. The user will receive change notifications for the block.

`POST /api/v1/subscriptions`

## Request body

- Subscription
  - `blockId` string, required — BlockID is id of the entity being subscribed to
  - `blockType` string, required
  - `createAt` integer, required — CreatedAt is the timestamp this subscription was created
  - `deleteAt` integer, required — DeleteAt is the timestamp this subscription was deleted, or zero if not deleted
  - `notifiedAt` integer, required — NotifiedAt is the timestamp of the last notification sent for this subscription
  - `subscriberId` string, required — SubscriberID is the id of the entity that is subscribing
  - `subscriberType` string, required

## Response `200`

success

- User — User is a user
  - `create_at` integer, required — Created time
  - `delete_at` integer, required — Deleted time, set to indicate user is deleted
  - `id` string, required — The user ID
  - `is_bot` boolean, required — If the user is a bot or not
  - `props` object, required — User settings
  - `update_at` integer, required — Updated time
  - `username` string, required — The user name

## Other responses

- `default` — internal error

## Changes

- **2022-03-22** `cdfed1e96572` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mattermost/apis/focalboard-server/changes/api/v1/subscriptions/post.md)

---

[API](https://skmtc.dev/mattermost/apis/focalboard-server.md) · [All operations](https://skmtc.dev/mattermost/apis/focalboard-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mattermost/focalboard-server/revisions/e8bd8dee7882/schema)