# Create a topic in the program

Creates new topic in the program

Endpoint: POST /v2/channels
Version: v2
Security: oauth2_as_a_user, oauth2_as_a_server

## Request fields (application/json):

  - `name` (string, required)
    The topic name.
    Example: "Company News"

  - `description` (string, required)
    The topic description.
    Example: "All the latest from our company."

  - `state` (string)
    The state of the topic. One of: archived, hidden, or published.
    Enum: "active", "published", "hidden", "available", "archived"

  - `auto_publish` (boolean)
    Whether the topic is set to auto-publish.
    Example: true

  - `auto_follow` (boolean)
    Whether the topic is set to auto-follow.
    Example: true

  - `recommended` (boolean)
    Whether the topic is recommended.
    Example: true

  - `targeted` (boolean)
    Whether the topic is targeted.
    Example: true

  - `user_submittable` (boolean)
    Whether the topic is user-submittable.
    Example: true

  - `groups` (array)
    A list of the audiences this topic is targeted to.
    Example: ["group1","group2"]

  - `contributors` (array)
    Contributor IDs
    Example: [1,2]

  - `promoted` (boolean)
    Is channel promoted
    Example: true

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.name` (string, required)
    The topic name.
    Example: "Company News"

  - `data.description` (string, required)
    The topic description.
    Example: "All the latest from our company."

  - `data.state` (string)
    The state of the topic. One of: archived, hidden, or published.
    Enum: "active", "published", "hidden", "available", "archived"

  - `data.auto_publish` (boolean)
    Whether the topic is set to auto-publish.
    Example: true

  - `data.auto_follow` (boolean)
    Whether the topic is set to auto-follow.
    Example: true

  - `data.recommended` (boolean)
    Whether the topic is recommended.
    Example: true

  - `data.targeted` (boolean)
    Whether the topic is targeted.
    Example: true

  - `data.user_submittable` (boolean)
    Whether the topic is user-submittable.
    Example: true

  - `data.groups` (array)
    A list of the audiences this topic is targeted to.
    Example: ["group1","group2"]

  - `data.contributor_count` (integer)
    How many contributors this topic has.
    Example: 12

  - `data.contributors` (array)
    Contributor IDs
    Example: [1,2]

  - `data.follower_count` (integer)
    How many followers this topic has.
    Example: 1000

  - `data.created_at` (string)
    When this topic was created in ISO8601 format and UTC timezone.
    Example: "2000-01-01T00:00:00Z"

  - `data.updated_at` (string)
    When this topic was last updated in ISO8601 format and UTC timezone.
    Example: "2000-01-01T00:00:00Z"

  - `data.promoted` (boolean)
    Is channel promoted
    Example: true

  - `data.id` (integer)
    Unique identifier for the topic.
    Example: 789