What is the Hedy API?
The Hedy API provides programmatic access to your meeting data, transcripts, summaries, and AI-generated insights. Whether you're building custom integrations, automating workflows, or creating new applications, the API gives you the power to extend Hedy's capabilities beyond the app. All API features require a Pro subscription with cloud sync enabled.
Getting Started with the API
Open the Hedy app and navigate to Account Settings
Scroll to the API Access section
Click Generate New API Key (Pro subscription required)
Copy your API key and store it securely - you won't be able to see it again
Visit our API documentation for detailed endpoint information
Security Note: Your API key provides full access to your Hedy data. Keep it secure and never share it publicly or commit it to version control.
API Capabilities
The Hedy API offers comprehensive access to your meeting intelligence:
Sessions: List, retrieve, and manage your meeting sessions
Transcripts: Access full transcripts with speaker identification and timestamps
Summaries: Get AI-generated meeting summaries and key points
Highlights: Create and retrieve important moments from your meetings
Topics: Organize sessions by topics and retrieve grouped data
Todos: Export and manage action items from meetings
Authentication
All API requests require authentication using your API key. Include it in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Webhooks (Coming Soon)
Set up webhooks to receive real-time notifications when events occur in your Hedy account:
In the API Access section, click Manage Webhooks
Click the + button to add a new webhook
Enter your HTTPS endpoint URL
Select the events you want to receive:
session.created - When a new recording session starts
session.ended - When a recording session completes
highlight.created - When a new highlight is added
todo.exported - When todos are exported from a session
Save your webhook and note the signing secret for payload verification
Common Use Cases
Project Management Integration: Automatically create tasks in your PM tool from meeting action items
Knowledge Management: Index meeting content in your company's knowledge base
CRM Integration: Update customer records with meeting insights
Analytics Dashboards: Build custom reports on meeting patterns and productivity
Workflow Automation: Trigger actions based on meeting content or completion
API Limits and Best Practices
Rate limits: 1000 requests per hour per API key
Use pagination for large data sets (limit parameter)
Cache responses when possible to reduce API calls
Handle errors gracefully with exponential backoff
Monitor webhook delivery and implement retry logic
Auto Export Todos
Enable automatic todo export to send action items to your integrated systems:
In the API Access section, toggle on Auto Export Todos
Todos will be automatically sent to your configured webhook endpoints
Each todo includes context, assignee suggestions, and meeting reference
Code Examples
Here's a simple example to get your recent sessions:
curl -X GET "https://api.hedy.ai/v1/sessions?limit=10" \ -H "Authorization: Bearer YOUR_API_KEY"
For more examples and detailed endpoint documentation, visit our API documentation.
Troubleshooting
401 Unauthorized Error
Verify your API key is correct and properly formatted
Ensure you have an active Pro subscription
Check that cloud sync is enabled in your account
Confirm the API key hasn't been regenerated (old keys are invalidated)
Empty Response or Missing Data
Ensure cloud sync is enabled - API only accesses cloud-synced data
Wait a few minutes after recording for data to sync
Check your date filters and pagination parameters
Verify you're using the correct endpoint for your data type
Webhook Not Receiving Events
Confirm your endpoint URL uses HTTPS (required)
Check that your server responds with 200 OK status
Verify webhook signature if implemented
Test your webhook using the "Test Webhook" button
Check firewall rules aren't blocking Hedy's servers
Rate Limit Exceeded
Implement caching to reduce redundant API calls
Use webhooks for real-time updates instead of polling
Batch operations where possible
Contact support if you need higher limits
Pro tip: Use webhooks instead of polling for real-time updates. This is more efficient and provides instant notifications when your data changes.
Privacy and Security
Your data security is our priority:
All API communication uses HTTPS encryption
API keys can be regenerated at any time (invalidates old key)
Webhook payloads are signed for verification
Data is only accessible with valid authentication
Getting Help
For API-specific questions:
Check the API documentation for detailed endpoint information
Read our API announcement blog post for examples and use cases
Join our Slack community for support and to share your integrations