Integration and API Spec

Integration and API Spec

Meeting and Decision Documentation

Provides the session end event trigger and the cloud recording file for transcription. Requires Server-to-Server OAuth for unattended access to recording assets without a user present.

// Trigger payload (key fields from recording.completed webhook)
event: 'recording.completed'
payload.object.uuid          // Zoom meeting UUID
payload.object.topic         // Meeting title
payload.object.start_time    // ISO 8601 datetime
payload.object.duration      // Minutes
payload.object.host_id       // Zoom user ID of host
payload.object.recording_files[].download_url  // Audio/video download URL
payload.object.recording_files[].file_type     // 'MP4' | 'M4A' | 'TRANSCRIPT'
// Output passed to Agent 1
zoom_meeting_uuid, meeting_title, start_time, duration, download_url

Receives the structured meeting summary and creates a new page in the designated Meetings database. Page properties and body content are populated by the automation using the template structure defined during setup.

// Input from Summary Agent
meeting_title, meeting_date, attendees[], summary_text, action_items[], zoom_meeting_uuid
// API call: POST /v1/pages
parent.database_id: NOTION_MEETINGS_DATABASE_ID
properties.Name.title[].text.content: meeting_title
properties['Meeting Date'].date.start: meeting_date
properties.Attendees.multi_select[]: attendees[]
properties['Zoom Meeting ID'].rich_text[].text.content: zoom_meeting_uuid
children[]: formatted summary and action item blocks
// Output
notion_page_id  // Stored and passed to Distribution Agent as reference URL

Receives the list of extracted action items and creates one task per item in the designated ClickUp list. Assignees and due dates are pre-populated from the agent output where determinable.

// Input from Summary Agent (one call per action item)
action_item_text, proposed_assignee_email, proposed_due_date, meeting_title, notion_page_url
// API call: POST /v2/list/{CLICKUP_LIST_ID}/task
name: action_item_text
assignees[]: [resolved_clickup_user_id]
due_date: proposed_due_date (Unix ms) or null
description: 'From meeting: ' + meeting_title + ' — ' + notion_page_url
priority: 3 (normal default)
// Output
clickup_task_id, clickup_task_url  // Appended to Notion page and included in email

Read-only source for the attendee list associated with the Zoom meeting. The orchestration layer matches the Zoom meeting to a Calendar event by time range and host email, then extracts the list of attendee email addresses for use by Gmail.

// Query: GET /calendar/v3/calendars/{GOOGLE_CALENDAR_ID}/events
timeMin: zoom_start_time - CALENDAR_MATCH_WINDOW_MINUTES
timeMax: zoom_start_time + CALENDAR_MATCH_WINDOW_MINUTES
// Output: list of attendee email addresses
attendees[].email  // Passed to Gmail send step

Sends the formatted follow-up email containing the meeting summary and action item list to all resolved attendee addresses. Uses a stored HTML template with defined placeholder variables.

// API call: POST /gmail/v1/users/me/messages/send
to: attendees[].email (joined as comma-separated string)
subject: 'Meeting Notes: ' + meeting_title + ' — ' + meeting_date
body (HTML): GMAIL_EMAIL_TEMPLATE with placeholders resolved
// Placeholders resolved at send time:
{{meeting_title}}, {{meeting_date}}, {{summary_text}},
{{action_items_html}}, {{notion_page_url}}
// Output
gmail_message_id  // Logged to run record for audit

Posts a condensed version of the meeting summary and action items to the designated team Slack channel. Uses a Slack app bot token scoped to message posting only.

// API call: POST https://slack.com/api/chat.postMessage
channel: SLACK_CHANNEL_ID (or resolved from SLACK_CHANNEL_ROUTING_MAP)
blocks: SLACK_MESSAGE_TEMPLATE with values:
  meeting_title, meeting_date, condensed_summary (max 500 chars),
  action_items_brief[], notion_page_url
// Output
slack_ts  // Thread timestamp, logged to run record

// Credential store — all keys required before first production run
// Zoom
ZOOM_ACCOUNT_ID                 // Server-to-Server OAuth account ID
ZOOM_CLIENT_ID                  // Server-to-Server OAuth client ID
ZOOM_CLIENT_SECRET              // Server-to-Server OAuth client secret
ZOOM_WEBHOOK_SECRET_TOKEN       // HMAC-SHA256 signature validation token

// Notion
NOTION_API_SECRET               // Internal integration token (secret_...)
NOTION_MEETINGS_DATABASE_ID     // Target database ID (32-char hex)
NOTION_PAGE_TEMPLATE_ID         // Optional: template page ID for formatting

// ClickUp
CLICKUP_API_TOKEN               // Personal or OAuth token
CLICKUP_TEAM_ID                 // Workspace/team numeric ID
CLICKUP_LIST_ID                 // Target list numeric ID
CLICKUP_ASSIGNEE_MAP            // JSON: { 'email@domain.com': clickup_user_id }

// Google (Calendar + Gmail — shared OAuth credentials)
GOOGLE_OAUTH_CLIENT_ID          // OAuth 2.0 client ID
GOOGLE_OAUTH_CLIENT_SECRET      // OAuth 2.0 client secret
GOOGLE_OAUTH_REFRESH_TOKEN      // Delegated user refresh token
GOOGLE_CALENDAR_ID              // Calendar ID (usually user email address)
CALENDAR_MATCH_WINDOW_MINUTES   // Int: window to match Zoom to Calendar event (default: 10)

// Gmail
GMAIL_EMAIL_TEMPLATE            // HTML string with placeholders
GMAIL_SENDER_NAME               // Display name for From field
GMAIL_REPLY_TO                  // Reply-to address

// Slack
SLACK_BOT_TOKEN                 // Bot User OAuth Token (xoxb-...)
SLACK_CHANNEL_ID                // Default target channel ID
SLACK_CHANNEL_ROUTING_MAP       // JSON: { 'meeting_type': 'channel_id' } (optional)
SLACK_MESSAGE_TEMPLATE          // Block Kit JSON template string

// Workflow config
REVIEW_TIMEOUT_MINUTES          // Int: approval wait before auto-proceed (default: 30)
AUTO_SEND_ON_TIMEOUT            // Bool: true = send after timeout, false = halt and alert