WhenWorks API for Developers

Build scheduling automation into your apps, AI agents, and workflows. The first scheduling API where voters need no account.

REST API

OpenAPI 3.1 Spec

MCP Server

For Claude & AI agents

ChatGPT Action

OAuth 2.0 integration

Quick Start

1. Get Your API Key

Generate an API key from your settings page

2. Create a Poll

curl -X POST https://www.whenworks.cc/api/v1/polls \
  -H "Authorization: Bearer ww_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team Lunch",
    "options": [
      {"date": "2026-03-30"},
      {"date": "2026-03-31"},
      {"date": "2026-04-01"}
    ]
  }'

3. Share the Poll URL

The response includes a poll_url. Anyone can vote on this URL without creating an account.

4. Get Best Times

curl https://www.whenworks.cc/api/v1/polls/{poll_id}/best-times \
  -H "Authorization: Bearer ww_live_your_api_key"

REST API

Base URL

https://www.whenworks.cc/api/v1

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer ww_live_your_api_key

Key Endpoints

POST /polls

Create a new scheduling poll

GET /polls

List your polls (paginated)

GET /polls/:id

Get poll details and options

GET /polls/:id/results

Get vote counts per option

GET /polls/:id/best-times

Get top-ranked meeting times

MCP Server

The Model Context Protocol (MCP) is Anthropic's open standard for connecting AI models to external tools. Use WhenWorks with Claude Desktop, Cursor, Continue, and other MCP-compatible clients.

Setup for Claude Desktop

1. Get your API key

Generate one from settings/api

2. Add to your Claude Desktop config

Edit ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "whenworks": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "https://www.whenworks.cc/api/mcp"
      ],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer ww_live_your_api_key"
      }
    }
  }
}

3. Restart Claude Desktop

You should see WhenWorks listed in the MCP tools menu.

Available MCP Tools

  • create_poll

    Create a scheduling poll and get a shareable link

  • get_poll_results

    Get current vote results for a poll

  • get_best_times

    Get top-ranked meeting times sorted by availability

  • list_my_polls

    List your recent polls with status

ChatGPT Action

Connect WhenWorks to ChatGPT using OAuth 2.0. Your ChatGPT users can create scheduling polls without leaving the conversation.

Setup Instructions

1. Create a GPT in ChatGPT

Go to ChatGPT → Create a GPT

2. Add Action

Import the OpenAPI schema:

https://www.whenworks.cc/openapi.yaml

3. Configure OAuth

Authentication Type: OAuth

Client ID: (contact support@whenworks.cc)

Client Secret: (contact support@whenworks.cc)

Authorization URL: https://www.whenworks.cc/api/oauth/authorize

Token URL: https://www.whenworks.cc/api/oauth/token

Scope: polls:read polls:write

4. Test

Try: "Create a poll for team lunch next week with 3 date options"

Need Help?

Have questions about the API or need higher rate limits?