MeetWho Public API

Build on the networking layer.

A simple JSON REST API to create events, sync guests, and read profiles. Same-origin endpoints under /api/public/v1, authenticated with your personal API key.

Introduction

Base URL: https://meetwho.app/api/public/v1. All responses are JSON with a Cache-Control: no-store header. CORS is enabled for browser use.

Authentication

Create a key in API keys and send it in the x-meetwho-api-key header. Keys start with mw_live_. You can also use Authorization: Bearer ….

curl https://meetwho.app/api/public/v1/users/me \
  -H "x-meetwho-api-key: mw_live_..."

Errors

Errors return a JSON body with an error.code and error.message. HTTP status reflects the class: 400 bad request, 401 unauthorized, 404 not found, 500 server error.

{ "error": { "code": "unauthorized", "message": "Invalid API key." } }

Users

GET/users/meGet the authenticated key owner's profile.

Events

GET/eventsList events you host. ?status=draft|published &limit=1..100

GET/events/:idGet a hosted event by id or slug.

POST/events/createCreate a new event.

curl -X POST https://meetwho.app/api/public/v1/events/create \
  -H "x-meetwho-api-key: mw_live_..." \
  -H "content-type: application/json" \
  -d '{
    "title": "Founders Coffee",
    "start_at": "2026-08-01T09:00:00Z",
    "end_at":   "2026-08-01T11:00:00Z",
    "timezone": "Europe/Istanbul",
    "location_type": "in_person",
    "location_city": "Istanbul",
    "location_country": "Turkey",
    "visibility": "public"
  }'

Guests

GET/events/:id/guestsList guests for a hosted event. ?limit=1..200

OpenAPI

Machine-readable spec at /api/public/v1/openapi. Import it into Postman, Insomnia, or your OpenAPI client of choice.