---
title: "Subscribe the user to a topic on a site (or update the subscription)."
method: POST
path: "/v5/notifications/{section_uuid}/topics/{topic_id}"
tags: ["SubscriptionsTopics"]
---

# Subscribe the user to a topic on a site (or update the subscription).

`POST /v5/notifications/{section_uuid}/topics/{topic_id}`

## Request

- Base URL: `https://notifications.viafoura.co`
- URL: `https://notifications.viafoura.co/v5/notifications/{section_uuid}/topics/{topic_id}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Enables current user to follow a previously created topic

## Path parameters

- `section_uuid` string, uuid, required
- `topic_id` string, required

## Request body

- TopicSubscriptionRequest
  - `topic_name` string, required
  - `topic_type` string

## Response `201`

Created

- SubscriptionResponse
  - `subscription_uuid` string, uuid

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict

---

[API](https://skmtc.dev/viafoura/apis/user-notifications-api.md) - [All operations](https://skmtc.dev/viafoura/apis/user-notifications-api/llms.txt) - [OpenAPI document](https://skmtc.dev/viafoura/apis/user-notifications-api/revisions/fa5f180726d8?raw)