Scheduling Automation for Developers
Automate scheduling with a real API
WhenToMeet has a proper API for automating scheduling. Build it into your app, let your AI agents create polls, sync with your systems. tRPC for type safety, webhooks for events, OpenAPI spec for codegen.
The Challenge
- ✕Scheduling tools have APIs that feel like an afterthought — limited endpoints, weird auth, no webhooks
- ✕Manually creating polls every time is tedious. You want automation.
- ✕Your AI assistant could schedule meetings but the APIs are too complex to explain
- ✕Need scheduling in your app but don't want to build timezone logic from scratch
- ✕Want programmatic scheduling without the enterprise price tag
How WhenToMeet Helps
Built for Automation
Every feature is accessible via API. Create polls, check availability, finalize times — all programmable. Perfect for scripts, apps, and AI agents.
AI Agent Ready
Clean API + llms.txt documentation means AI agents can use it. Claude, ChatGPT, or your custom agents can schedule meetings with a single prompt.
Webhook Events
Real-time notifications when events are created, finalized, or bookings come in. Build reactive systems without polling.
Timezone Handling
Store times in UTC, display in user's timezone. We handle DST transitions and timezone edge cases so you don't have to.
Simple Integration
One API call to create an event. Get back a shareable URL. No complex OAuth flows or SDK setup required.
Key Features
OpenAPI Spec
Full OpenAPI 3.0 specification at /api/openapi.json. Generate clients in any language. Auto-complete in your IDE.
tRPC Endpoints
Type-safe API with tRPC. Full autocomplete in TypeScript. Request/response validation built in.
Scoped API Keys
Create keys with specific permissions. Read-only for analytics. Write-only for event creation. Revoke anytime.
Webhooks
Subscribe to events: event.created, event.finalized, booking.confirmed. We POST to your endpoint with retries.
llms.txt for AI Agents
Machine-readable docs at /llms.txt. Your AI assistant understands our API without reading HTML docs. Just point it to the URL.
Get Started in 3 Steps
Generate API key
Create an API key from your dashboard. Choose scopes (read, write, or both). Copy the key.
Call the API
POST to /api/v1/polls with title and time slots. Get back poll ID and shareable URL. Or let your AI agent do it.
Automate
Poll status via API or use webhooks for updates. Finalize programmatically when everyone has voted. Integrate with your workflow.
Best Practices for Scheduling Automation
- ✓Store event IDs in your database. not the full event data. Use the API as source of truth.
- ✓Use webhooks instead of polling for real-time updates. More efficient. less API calls.
- ✓For AI agents: point them to /llms.txt so they understand the API without explanations.
- ✓Generate separate API keys for different integrations. Easier to rotate if one is compromised.
- ✓Use the OpenAPI spec to generate typed clients in your language. Don't write HTTP calls by hand.
Frequently Asked Questions
Is the API a second-class citizen?+−
No. WhenToMeet is built as scheduling infrastructure. The UI and API use the same backend. Every feature is accessible programmatically.
What's the rate limit?+−
Free tier: 32 requests lifetime. Pro tier: 1000 requests/hour. Enterprise: custom limits. All plans include X-RateLimit headers in responses.
Can I use this without the UI?+−
Yes. Create events, collect availability, finalize times — all via API. The UI is there when you need it, but automation is fully supported.
Can AI agents use the API?+−
Yes. We publish llms.txt so AI assistants understand our API. Claude, ChatGPT, or custom agents can create and manage scheduling events. Just give your AI the API key and point it to our docs.
What frameworks work well with the API?+−
Any framework that can make HTTP requests. TypeScript projects get full type safety with our tRPC client. Python, Go, Ruby, PHP all work via REST.
How do webhooks work?+−
Register a webhook URL in your dashboard. We POST JSON payloads when events happen. Verify signatures with the X-Webhook-Signature header. Built-in retries with exponential backoff.
Is this suitable for building my own scheduling product?+−
Yes. Use WhenToMeet as scheduling infrastructure. Create events via API, embed polls in your app, or build completely custom interfaces on top of our backend.