Custom Integrations

Connect HyperPlanner to your favorite tools. Sync calendars, receive notifications, and build custom workflows with our powerful API.

Available Integrations

HyperPlanner connects seamlessly with the tools you already use. From calendar synchronization to task notifications, extend your productivity workflow across platforms.

📅

Google Calendar

Two-way sync keeps your events and tasks perfectly aligned across both platforms.

📆

Outlook Calendar

Sync with Microsoft 365 and Outlook.com calendars for enterprise-ready planning.

💬

Slack

Receive task notifications, due date reminders, and daily summaries in your channels.

⚡

Zapier

Connect to 5,000+ apps with automated workflows. Coming Soon

🔗

IFTTT

Create simple automation recipes for your tasks and events. Coming Soon

💻

REST API

Build your own integrations with our comprehensive developer API.

Account Required

Integrations require a HyperPlanner account to securely store OAuth tokens and sync preferences. Demo mode users can preview integration settings but cannot activate connections.

Setting Up Integrations

Follow these steps to connect your first integration. The process is similar for all supported services.

General Setup Process

Open Integration Settings
Navigate to Settings > Integrations or press Cmd/Ctrl + , and select the Integrations tab
Select Your Service
Click on the integration you want to connect (e.g., Google Calendar, Slack)
Authorize the Connection
Click "Connect" and sign in to the external service. Grant HyperPlanner the requested permissions
Configure Sync Options
Choose what to sync, set sync frequency, and configure notification preferences
Test the Connection
Click "Test Connection" to verify everything is working. Create a test task to confirm sync

Connecting Google Calendar

Click "Connect Google Calendar"
You'll be redirected to Google's authorization page
Select Your Google Account
Choose the account containing the calendars you want to sync
Grant Calendar Permissions
Allow HyperPlanner to view and edit your calendar events
Choose Calendars to Sync
Select specific calendars or sync all. You can change this later
Set Sync Direction
Choose two-way sync (recommended), HyperPlanner to Google only, or Google to HyperPlanner only

Multiple Calendars

You can connect multiple Google accounts and select which calendars from each account to sync. Color-code them in HyperPlanner to keep work and personal events visually distinct.

Connecting Outlook Calendar

Click "Connect Outlook Calendar"
You'll be redirected to Microsoft's authorization page
Sign in with Microsoft
Use your Microsoft 365, Outlook.com, or work/school account
Accept Permissions
Approve calendar read/write access for HyperPlanner
Select Calendars
Choose which Outlook calendars to sync with HyperPlanner

Connecting Slack

Click "Connect Slack"
You'll be redirected to Slack's authorization page
Select Your Workspace
Choose the Slack workspace where you want to receive notifications
Choose Notification Channel
Select a channel for notifications or enable DMs to the HyperPlanner bot
Configure Notification Types
Choose which events trigger Slack messages (due dates, completions, daily summaries)

Calendar Sync Configuration

Fine-tune how your calendars sync with HyperPlanner for seamless planning across platforms.

Sync Options

Option	Description	Default
Sync Direction	Two-way, HyperPlanner-to-Calendar, or Calendar-to-HyperPlanner	Two-way
Sync Frequency	Real-time, every 5 minutes, every 15 minutes, or manual	Every 5 min
Sync Range	Past and future date range for syncing events	30 days past, 90 days future
Include All-Day Events	Sync all-day calendar events as HyperPlanner tasks	Yes
Sync Task Status	Mark calendar events complete when tasks are done	Yes

Event Mapping

Control how calendar events appear in HyperPlanner:

# Default mapping rules
Calendar Event       ->  HyperPlanner Task
---------------------------------------------
Event Title          ->  Task Title
Event Description    ->  Task Notes
Start Time           ->  Scheduled Time
Duration             ->  Time Block Duration
Event Color          ->  Task Context (configurable)
Recurring Event      ->  Recurring Task

Conflict Resolution

When the same event is modified in both places, HyperPlanner uses these rules:

Last Write Wins: The most recent change takes precedence
HyperPlanner Priority: Always prefer HyperPlanner changes
Calendar Priority: Always prefer calendar changes
Ask Me: Prompt for each conflict (not recommended for real-time sync)

Initial Sync Notice

The first sync may take several minutes depending on your calendar history. Avoid making changes in either platform until the initial sync completes to prevent duplicates.

Selective Sync Filters

Only sync events matching specific criteria:

# Filter examples
Include events containing:     "work", "meeting"
Exclude events containing:     "personal", "private"
Only sync events with color:   Blue, Green
Skip declined invitations:     Yes
Skip tentative events:         No

Notification Settings

Configure when and how you receive notifications through connected services like Slack.

Slack Notification Types

🔔

Due Date Reminders

Get notified when tasks are due soon or overdue.

✅

Task Completions

Celebrate wins with completion notifications.

📅

Daily Summary

Morning digest of today's tasks and events.

📈

Weekly Review

End-of-week summary with productivity stats.

Notification Timing

Notification Type	Timing Options
Due Date Reminder	1 hour, 1 day, 3 days, or 1 week before
Overdue Alert	Immediately, or daily digest
Daily Summary	Custom time (e.g., 8:00 AM)
Weekly Review	Day and time (e.g., Friday 5:00 PM)

Quiet Hours

Prevent notifications during specific times:

# Quiet hours configuration
Enabled:        Yes
Start Time:     10:00 PM
End Time:       8:00 AM
Days:           All days / Weekdays only / Custom
Exceptions:     Allow urgent/high-priority task reminders

Channel vs DM

Use a dedicated Slack channel for team visibility on shared projects, or choose DM for personal task reminders. You can configure different destinations for different notification types.

Building Custom Integrations via API

Our REST API allows developers to build custom integrations, sync with proprietary systems, and create automated workflows tailored to specific needs.

Getting Started with the API

Generate an API Key
Go to Settings > Integrations > API Keys and click "Generate New Key"
Review API Documentation
Access the full API reference at api.hyperplanner.app/docs
Test with the Sandbox
Use our interactive API sandbox to test endpoints before implementing
Build Your Integration
Use any HTTP client or our official SDKs (JavaScript, Python, Ruby)

API Authentication

All API requests require authentication via Bearer token:

# Example API request
curl -X GET "https://api.hyperplanner.app/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Core API Endpoints

Endpoint	Method	Description
/v1/tasks	GET, POST	List all tasks or create a new task
/v1/tasks/:id	GET, PUT, DELETE	Get, update, or delete a specific task
/v1/events	GET, POST	List all events or create a new event
/v1/events/:id	GET, PUT, DELETE	Get, update, or delete a specific event
/v1/projects	GET, POST	List all projects or create a new project
/v1/webhooks	GET, POST, DELETE	Manage webhook subscriptions

Example: Creating a Task

# Create a new task via API
curl -X POST "https://api.hyperplanner.app/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Review quarterly report",
    "due_date": "2024-01-15T17:00:00Z",
    "priority": "high",
    "context": "work",
    "tags": ["reports", "quarterly"],
    "notes": "Include revenue projections"
  }'

# Response
{
  "id": "task_abc123",
  "title": "Review quarterly report",
  "status": "pending",
  "due_date": "2024-01-15T17:00:00Z",
  "priority": "high",
  "context": "work",
  "tags": ["reports", "quarterly"],
  "created_at": "2024-01-10T09:30:00Z"
}

Webhooks

Subscribe to events and receive real-time notifications when changes occur:

# Register a webhook
POST /v1/webhooks
{
  "url": "https://your-server.com/hyperplanner-webhook",
  "events": ["task.created", "task.completed", "task.updated"],
  "secret": "your_webhook_secret"
}

# Available webhook events
task.created       - New task created
task.updated       - Task modified
task.completed     - Task marked complete
task.deleted       - Task removed
event.created      - New calendar event
event.updated      - Event modified
event.deleted      - Event removed

Rate Limits

API requests are limited to 100 requests per minute for free accounts and 1,000 requests per minute for Pro accounts. Webhook deliveries do not count against your rate limit.

Troubleshooting Common Issues

Encountering problems with integrations? Here are solutions to the most common issues.

Connection Issues

This usually happens when third-party cookies are blocked. Try:

Enable third-party cookies temporarily during authorization
Disable browser extensions that might block OAuth flows
Try using an incognito/private window
Clear your browser cache and try again

Microsoft 365 admin policies may be blocking the connection:

Contact your IT admin to whitelist HyperPlanner
Try connecting with a personal Outlook.com account first
Check if your organization requires admin consent for third-party apps

Verify your Slack integration settings:

Check that the correct channel is selected
Ensure the HyperPlanner bot is added to the channel
Verify notification types are enabled in settings
Check if Quiet Hours are currently active
Try disconnecting and reconnecting the Slack integration

Sync Issues

Duplicates can occur during initial sync or when sync direction is misconfigured:

Wait for the initial sync to complete before making changes
Check if you have multiple calendars syncing the same events
Go to Settings > Integrations > Advanced and run "Deduplicate Events"
Ensure sync direction is set correctly (avoid syncing back and forth accidentally)

Real-time sync requires specific conditions:

Verify sync frequency is set to "Real-time" in integration settings
Check your internet connection stability
Real-time sync uses WebSockets; some corporate firewalls may block these
Try manually triggering a sync from the integration panel

Recurring event sync has known limitations:

Complex recurrence patterns (e.g., "third Thursday of each month") may not sync perfectly
Editing a single instance of a recurring event can cause sync issues
Try deleting the recurring event and recreating it in HyperPlanner
Check if the recurrence end date is within your sync range

API Issues

Your API key may be invalid or expired:

Verify the API key is correct and includes the full token
Check if the key was revoked in Settings > API Keys
Ensure you're using "Bearer" prefix: Authorization: Bearer YOUR_KEY
Generate a new API key if the current one is compromised

You've exceeded the API rate limit:

Implement exponential backoff in your API client
Cache responses where possible to reduce API calls
Use webhooks for real-time updates instead of polling
Upgrade to Pro for higher rate limits (1,000 requests/minute)

Still Having Issues?

If these solutions don't resolve your problem, visit our Community Forum or Contact Support. Include your integration type, browser/client info, and any error messages.

← Theme Lab Tutorial Data Export/Import →