← Back

yup/no

API Documentation

Overview

Event RSVP platform with token-based access, webhooks, calendar integration (iCal/Schema.org/JSCalendar), and MCP support. No accounts required.

API Endpoints

# Public
GET  /api/v1/events/{eventToken}                  → Event details
GET  /api/v1/events/{eventToken}/ical             → iCalendar
GET  /api/v1/events/{eventToken}/schema.json      → Schema.org
GET  /api/v1/events/{eventToken}/jscalendar.json  → JSCalendar

# Admin
POST /api/v1/events                               → Create event
PUT  /api/v1/events/{adminToken}                  → Update event
GET  /api/v1/events/{eventToken}/rsvps            → List RSVPs
     Authorization: Bearer {adminToken}

# RSVP
POST /api/events/{eventToken}/rsvp               → Submit RSVP

Create Event

POST /api/v1/events
Content-Type: application/json

{ "title": "Launch Party", "eventDate": "2024-03-15T18:00:00" }

→ { "adminToken": "...", "eventToken": "...", "links": {...} }

Event Fields

{
  "title": "string",              // Event name
  "eventDate": "ISO 8601",        // Start time
  "endDate": "ISO 8601",          // End time
  "timezone": "America/New_York", // IANA timezone
  "location": "string",           // Physical address
  "virtualLocation": "URL",       // Video call link
  "latitude": 40.71, "longitude": -74.01,
  "organizerName": "string",
  "organizerEmail": "email",
  "description": "string",
  "imageUrl": "URL",
  "status": "draft|published|cancelled",
  "showGuestList": true,
  "collectEmail": true,
  "collectPhone": false,
  "webhookUrl": "URL"             // RSVP notifications
}

title required. All other fields optional. Tokens auto-generated.

Submit RSVP

POST /api/events/{eventToken}/rsvp
Content-Type: application/json

{
  "name": "John Smith",
  "attending": true,
  "plusOne": true,
  "email": "john@example.com",
  "phone": "+1234567890"
}

Webhooks

Set webhookUrl to receive RSVP notifications. Slack and Discord URLs auto-format with native styling.

POST {webhookUrl}

{
  "action": "created|deleted",
  "event": { "token", "title", "eventDate", "location" },
  "rsvp": { "id", "name", "email", "phone", "plusOne", "attending" }
}

Calendar Integration

# Subscribe in any calendar app
https://yupno.io/api/v1/events/{eventToken}/ical
webcal://yupno.io/api/v1/events/{eventToken}/ical

iCal includes: TZID, ORGANIZER, GEO, X-CONFERENCE, STATUS.

MCP Server

Manage events from Claude, Cursor, or any MCP-compatible assistant:

{ "mcpServers": { "yupno": {
    "command": "node",
    "args": ["/path/to/yupno/mcp/index.js"]
}}}

Tools: create_event, get_event, update_event, export_rsvps, delete_rsvp

CORS

All endpoints allow * origin with GET/POST/PUT/DELETE methods.