---
title: "Subscribes the current user to an entity."
method: PUT
path: "/subscriptions/{entity}/{entityID}"
tags: ["subscriptions"]
---

# Subscribes the current user to an entity.

`PUT /subscriptions/{entity}/{entityID}`

Subscribes the current user to an entity.

## Path parameters

- `entity` string, required
- `entityID` string, required

## Response `201`

The subscription

- ModelsSubscription
  - `created` string — A timestamp when this subscription was created. You cannot change this value.
  - `entity` integer
  - `entity_id` integer — The id of the entity to subscribe to.
  - `id` integer — The numeric ID of the subscription

## Other responses

- `403` — The user does not have access to subscribe to this entity.
- `412` — The subscription entity is invalid.
- `500` — Internal error

---

[API](https://skmtc.net/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.net/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)