Free Meeting Time

API Documentation

Use the API to create and manage your free time requests from another system.

Authentication

Sign in, create an API key under API Keys, and send it as a bearer token. The key is shown once.

Authorization: Bearer fmt_your_generated_key
Content-Type: application/json

Endpoints

GET /api/v1/polls.php?status=active&limit=50&offset=0

List your active requests, with optional paging and historical results.

POST /api/v1/polls.php

Create a request with dates, time ranges and optional recipients.

GET /api/v1/poll.php?id={poll-id}

Read one request, its slots and response status.

PATCH /api/v1/poll.php?id={poll-id}

Update request details or add and remove dates.

DELETE /api/v1/poll.php?id={poll-id}

Delete one of your requests and its related records.

GET|POST /api/v1/participants.php?id={poll-id}

Read response status or add recipients and optionally send invitations.

Create Request Example

{
  "title": "Planning session",
  "description": "Choose times that work.",
  "organizer_name": "Alex",
  "slot_duration_minutes": 60,
  "dates": [
    { "date": "2026-06-01", "start_hour": 9, "end_hour": 12 }
  ],
  "recipients": [
    { "name": "Sam", "email": "[email protected]" }
  ],
  "send_invitations": true
}

Limits And Security

JSON bodies are limited to 1 MB. Lists are paged. A maximum of 50 invitation emails may be triggered in one API request.

API keys only access requests owned by the signed-in user. Store keys securely and revoke a key immediately if it may have been disclosed.