---
title: "Create insight channel"
method: POST
path: "/insight-channels"
tags: ["Insight Channels"]
---

# Create insight channel

`POST /insight-channels`

## Request

- Base URL: `https://studio.fintechstudios.com/api/v1`
- URL: `https://studio.fintechstudios.com/api/v1/insight-channels`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Create a new insight channel for organizing published insights.

## Request body

- object
  - `name` string, required: Channel name
  - `description` string: Channel description

## Response `201`

Insight channel created

- object
  - `data` InsightChannel
    - `id` string
    - `name` string
    - `description` string, nullable
    - `icon` string, nullable
    - `color` string, nullable
    - `source_type` string
    - `schedule` string, nullable: Cron expression for scheduled runs
    - `is_active` boolean
    - `insight_count` integer
    - `last_run_at` string, date-time, nullable
    - `last_run_status` 'success' | 'failed' | 'skipped', nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time, nullable
  - `meta` Meta
    - `request_id` string
    - `credits_used` integer
    - `credits_remaining` integer
    - `rate_limit` object
      - `limit` integer
      - `remaining` integer
      - `reset` integer

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/fintechstudios/apis/fts-studio-api.md) · [All operations](https://skmtc.dev/fintechstudios/apis/fts-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintechstudios/apis/fts-studio-api/revisions/4886597d1d96?raw)