DOdovetail
Channels

Create channel

Changed on

Create a new channel in your workspace. A channel is an automated pipeline for analyzing customer feedback at scale. You must specify a content_type (e.g. APP_REVIEW, NPS_FEEDBACK, SUPPORT_TICKETS) that tells Dovetail what kind of data will flow through this channel.

Optionally place the channel in a folder via project_category_id.

Once created, send data to the channel using the Create data point (POST /v1/channels/data) endpoint. Dovetail will automatically classify each data point into topics.

Returns the channel object with its initial set of AI-generated topics.

Required scope: channel:write

post/v1/channels

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/channels
  • Auth
    HTTP bearer

Request body

titlestring required

The channel's title.

content_type'APP_REVIEW' | 'CHURN_REASONS' | 'NPS_FEEDBACK' | 'PRODUCT_REVIEW' | 'SUPPORT_TICKETS' required

The channel's content type. Possible values: [APP_REVIEW, CHURN_REASONS, NPS_FEEDBACK, PRODUCT_REVIEW, SUPPORT_TICKETS]

project_category_idstring

Unique identifier of the folder you want to save this channel.

Response

201

Changes

  • 8abea327e6b9Revision changes
    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status