zapier-platform-hedy

CLI-managed source for the Hedy Zapier integration. Mirrors the surface of n8n-nodes-hedy and make-app-hedy.

This is a Zapier Platform CLI project. The integration was originally built in the Zapier Visual Builder; from v1.3.0 onward it lives here as code.

Requirements

• Node.js 22+ (the Zapier CLI does not support Node 20)
• zapier-platform-cli installed globally: npm install -g zapier-platform-cli
• Authenticated via zapier-platform login

Quick start

npm install
npm run build
npm run validate          # zapier-platform validate
npm test                  # jest smoke tests

To push a new version to Zapier:

npm run push              # builds + zapier-platform push

To migrate users from a previous version once the new one is promoted:

zapier-platform migrate 1.1.0 1.3.0

Authentication

API key (Bearer token) plus an optional US/EU region picker (US default, set EU if your Hedy account uses EU data residency).

Connection label: {{name}} ({{email}}) from GET /me.

Capabilities

Triggers (REST hooks via POST /webhooks → DELETE /webhooks/{id})

Key	Display label	Event	Status
completed_session	Session Completed	session.ended	preserved from v1.1.0
new_session	New Session	session.created	added in 1.3.0
exported_session	Session Exported	session.exported	added in 1.3.0
new_highlight	Highlight Created	highlight.created	preserved from v1.1.0
todo_exported	To-Do Exported	todo.exported	preserved from v1.1.0

Searches

Key	Display label	Status
list_sessions	Find Sessions	added in 1.3.0
list_highlights	Find Highlights	added in 1.3.0
list_todos	Find To-Dos	added in 1.3.0
list_topics	Find Topics	added in 1.3.0
get_topic	Get Topic Details	added in 1.3.0
list_topic_sessions	Find Sessions in Topic	added in 1.3.0
list_contexts	Find Session Contexts	added in 1.3.0
get_context	Get Session Context Details	added in 1.3.0

Creates / writes

Key	Display label	Status
get_session	Get Session Details	preserved from v1.1.0 (was a "create" by legacy convention; cannot move without breaking key)
get_highlight	Get Highlight Details	preserved from v1.1.0
create_topic	Create Topic	added in 1.3.0
update_topic	Update Topic	added in 1.3.0
delete_topic	Delete Topic	added in 1.3.0
create_context	Create Session Context	added in 1.3.0
update_context	Update Session Context	added in 1.3.0
delete_context	Delete Session Context	added in 1.3.0
api_request	Custom API Request	added in 1.3.0

Project layout

src/
├── index.ts                # registers everything
├── authentication.ts       # API key + region picker
├── shared/
│   ├── client.ts           # auth headers, region routing, error handling
│   ├── samples.ts          # shared sample objects
│   ├── outputFields.ts     # output field contracts (DO NOT rename keys)
│   └── webhook.ts          # subscribe/unsubscribe helpers
├── triggers/               # 5 REST hook triggers
├── searches/               # 7 read actions
└── creates/                # 9 write or legacy-create actions
test/                       # jest smoke tests