View as Markdown
Hedy icon

Hedy ACTION

Create Topic

Creates a new Hedy meeting topic for organizing sessions. Topics can include a custom AI analysis context (topicContext) — up to 20,000 characters of instructions that guide Hedy's AI when analyzing meetings in this topic. Use Update Topic to modify an existing topic, or Delete Topic to remove one. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Hedy account once, then configure and run Create Topic from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "hedy-create-topic",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    hedy: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    description: "Description",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Topic inputs
Property Type Description
name Name string
The topic name (maximum 100 characters).
Required
description Description string
An optional description of the topic (maximum 500 characters).
Optional
color Color string
Optional hex color code for the topic (e.g. #4CAF50).
Optional
iconName Icon Name string
Optional icon identifier for the topic.
Optional
topicContext Topic Context string
Optional custom AI instructions for analyzing sessions in this topic (maximum 20,000 characters). Use this to focus Hedy's analysis on specific themes, extract particular insights, or follow custom frameworks.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
hedy-create-topic
Version
0.0.2
App
Hedy
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes