CONNECT APP
Build with Hedy
Real-Time Meeting and Class Coach
Artificial Intelligence (AI)
- API key
MCP
Give your agent Hedy tools
Every Hedy action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Hedy account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "hedy",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Create Session Context:
const result = await mcp.callTool({
name: "hedy-create-session-context",
arguments: {
title: "Title",
content: "Content",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "hedy",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create Session Context:
result = await session.call_tool("hedy-create-session-context", {
"title": "Title",
"content": "Content",
})API PROXY
Call the Hedy API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Hedy API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.hedy.bot/sessions",
})
// Any allowed Hedy endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.hedy.bot/sessions
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuaGVkeS5ib3Qvc2Vzc2lvbnM?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Hedy actions from your backend
Connect a user's Hedy account once, then run Create Session Context on their behalf from your own code — TypeScript, Python, or plain HTTP.
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-session-context",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
hedy: { authProvisionId: "apn_xxxxxxx" },
title: "Title",
content: "Content",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="hedy-create-session-context",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"hedy": {"authProvisionId": "apn_xxxxxxx"},
"title": "Title",
"content": "Content",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "hedy-create-session-context",
"configured_props": {
"hedy": { "authProvisionId": "apn_xxxxxxx" },
"title": "Title",
"content": "Content"
}
}'TOOLS
Hedy actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create Session Context
actionCreates a new reusable Hedy session context — a named set of custom AI instructions that can be applied to meeting recordings to guide analysis. Free accounts are limited to 1 context; Pro accounts can create multiple. SetisDefaulttotrueto make this context automatically applied to new sessions. Use Update Session Context to modify an existing context, or Delete Session Context to remove one. See the documentationWritev0.0.2 -
Create Topic
actionCreates 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 documentationWritev0.0.2 -
Delete Session Context
actionDeletes a Hedy session context. This action is irreversible. If you delete the current default context, the most recently created remaining context is automatically promoted to default. Use Get Many Session Contexts to find the context ID before deleting. See the documentationWritev0.0.2 -
Delete Topic
actionDeletes a Hedy topic. Sessions that were linked to the topic are NOT deleted — they are unlinked and remain in your account. This action is irreversible. Use Get Many Topics to find the topic ID before deleting. See the documentationWritev0.0.2 -
Get Highlight
actionRetrieves full details for a single AI-generated highlight by ID, including the raw quote, cleaned quote, main idea, and AI insight. Use Get Many Highlights or Get Highlights By Session first to find a highlight ID. See the documentationRead-onlyv0.0.2 -
Get Highlights By Session
actionRetrieves all AI-generated highlights for a specific Hedy session. Use Get Many Sessions first to find the session ID. Each result includes a highlight ID, title, and timestamp within the session. Use Get Highlight with the highlight ID to fetch the full detail including raw quote, cleaned quote, main idea, and AI insight. See the documentationRead-onlyv0.0.2 -
Get Many Highlights
actionRetrieves a paginated list of AI-generated highlights across all Hedy sessions. Each highlight includes a title, timestamp, and the session it came from. Use Get Highlight with a specific highlight ID to fetch the full detail including raw quote, cleaned quote, main idea, and AI insight. To list highlights for a specific session only, use Get Highlights By Session. See the documentationRead-onlyv0.0.2 -
Get Many Session Contexts
actionRetrieves all reusable Hedy session contexts, including title, content, and which one is set as the default. Session contexts are custom AI instruction sets that guide Hedy's analysis of meeting recordings. Use this tool to browse available contexts or to find a context ID to pass to Get Session Context, Update Session Context, or Delete Session Context. See the documentationRead-onlyv0.0.2 -
Get Many Sessions
actionRetrieves a paginated list of Hedy meeting sessions ordered from most recent. Each session includes its title, start/end times, duration, and session type. Use this tool to browse recent meetings or to find a session ID to pass to Get Session for full transcript and summary details. To list sessions within a specific topic, use Get Topic Sessions instead. Paginate using theaftercursor from the response'spaginationfield. See the documentationRead-onlyv0.0.2 -
Get Many Todos
actionRetrieves a paginated list of action items (todos) across all Hedy sessions. Each item includes the todo text, completion status, optional due date, and the session it came from. To get todos for a specific session only, use Get Todos By Session. Use Get Todo with a specific todo ID to fetch a single item's full detail. See the documentationRead-onlyv0.0.2 -
Get Many Topics
actionRetrieves all Hedy meeting topics with their session counts, last session date, dominant session type, and cached AI overview. Use this tool to browse available topics or to find a topic ID to pass to Get Topic, Get Topic Sessions, Update Topic, or Delete Topic. See the documentationRead-onlyv0.0.2 -
Get Session
actionRetrieves full details for a single Hedy meeting session by ID, including the complete transcript, meeting minutes, recap, session notes, highlights array, and action items (todos). Use Get Many Sessions first to list sessions and obtain a session ID. See the documentationRead-onlyv0.0.2 -
Get Session Context
actionRetrieves full details for a single reusable Hedy session context by ID, including the title, content, and whether it is the default context. Session contexts are reusable custom AI instruction sets that guide Hedy's analysis across multiple meetings. Use Get Many Session Contexts first to list available contexts and obtain a context ID. See the documentationRead-onlyv0.0.2 -
Get Todo
actionRetrieves a single action item (todo) by its ID within a session, returning text, completion status, due date, and associated topic. Both the session ID and todo ID are required. Use Get Todos By Session first to list todos for a session and obtain todo IDs. See the documentationRead-onlyv0.0.2 -
Get Todos By Session
actionRetrieves all action items (todos) for a specific Hedy session. Use Get Many Sessions first to find the session ID. Each result includes the todo text, completion status, and optional due date. Use Get Todo with the session ID and todo ID for single-item detail. See the documentationRead-onlyv0.0.2 -
Get Topic
actionRetrieves full details for a single Hedy topic by ID, including the complete custom AI analysis context (topicContext), cached overview, and session statistics. ThetopicContextfield (up to 20,000 characters) contains custom instructions that guide Hedy's AI analysis for sessions in this topic. Use Get Many Topics first to list topics and obtain a topic ID. See the documentationRead-onlyv0.0.2 -
Get Topic Sessions
actionRetrieves a paginated list of Hedy sessions belonging to a specific topic. Use Get Many Topics first to find the topic ID. Paginate using thestartAftercursor (a session ID from the last item in the previous page). See the documentationRead-onlyv0.0.2 -
Update Session Context
actionUpdates an existing Hedy session context. All fields are optional — only the fields you provide will be changed. If you setisDefaulttotrue, this context becomes the default and the previous default is demoted. Use Get Many Session Contexts to find the context ID. See the documentationWritev0.0.2 -
Update Topic
actionUpdates properties of an existing Hedy topic. All fields are optional — only the fields you provide will be changed. To clear the custom AI context, pass an empty string ornullfortopicContext. Use Get Many Topics to find the topic ID. See the documentationWritev0.0.2
No Hedy triggers are available yet.
- App slug
- hedy
- Authentication
- API key
- Categories
- Artificial Intelligence (AI)
- Actions
- 19
- Triggers
- 0
- API proxy
- Available