---
title: "Create new topic"
method: POST
path: "/api/users/:userId/topics"
tags: ["topic"]
---

# Create new topic

`POST /api/users/:userId/topics`

Logged in user can create a new topic

## Path parameters

- `userId` string, required

## Request body

- object
  - `visibility` 'public' | 'private'
  - `categories` string[]
  - `hashtag` string, nullable
  - `endsAt` string, timestamp, nullable
  - `sourcePartnerObjectId` string — related object id on partner

## Response `200`

New topic created successfully

- object
  - `status` object
    - `code` integer
  - `data` Topic
    - `id` string, uuid
    - `title` string, nullable
    - `description` string, html
    - `status` 'inProgress' | 'voting' | 'followUp' | 'closed'
    - `visibility` 'public' | 'private'
    - `categories` string[]
    - `sourcePartnerId` string, uuid
    - `sourcePartnerObjectId` string
    - `creator` object
      - `id` string, uuid
      - `name` string
    - `tokenJoin` string, nullable — This value is only returned by authorized endpoints
    - `padUrl` string
    - `endsAt` string
    - `pinned` boolean — This value is only returned by authorized endpoints
    - `hashtag` string
    - `createdAt` string
    - `updatedAt` string

## Changes

- **2019-01-08** `59c81251b4e5` — 1 warning, 1 info
  - removed the optional property `data/favourite` from the response with the `200` status
  - added the optional property `data/pinned` to the response with the `200` status
- **2018-12-17** `f8b47b43a084` — 1 info
  - added the optional property `data/favourite` to the response with the `200` status
- **2018-08-20** `3ff54b27e8aa` — 1 info
  - endpoint added
- **2018-08-20** `ba36cd387928` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/citizenos/apis/citizenos-api/changes/api/users/:userId/topics/post.md)

---

[API](https://skmtc.dev/citizenos/apis/citizenos-api.md) · [All operations](https://skmtc.dev/citizenos/apis/citizenos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citizenos/citizenos-api/revisions/ca28908e6b75/schema)