RSVP as a guest
Create an RSVP from the browser. Requires a Turnstile token whenever the event's `turnstile_site_key` is not null (403 `bot_check_failed` without a valid one). Limited to 5 per minute and 30 per hour per IP per event. If the organizer set allowed origins, the `Origin` header must match (403 `origin_not_allowed`). An email already going or on the waitlist answers 409 `already_registered` and re-sends that guest their manage link (at most once an hour). Send an `Idempotency-Key` to make retries safe: a retry returns the first response, manage token included. Never cached.
Create an RSVP from the browser. Requires a Turnstile token whenever the event's turnstile_site_key is not null (403 bot_check_failed without a valid one). Limited to 5 per minute and 30 per hour per IP per event. If the organizer set allowed origins, the Origin header must match (403 origin_not_allowed). An email already going or on the waitlist answers 409 already_registered and re-sends that guest their manage link (at most once an hour). Send an Idempotency-Key to make retries safe: a retry returns the first response, manage token included. Never cached.
id*string^evt_[0-9A-Za-z]{6,64}$idempotency-key?stringSend a unique value (a UUID works) to make retries safe. A replay within 24 hours returns the first response; the same key with a different body is a 409 idempotency_conflict.
1 <= length <= 255application/json- body
name*string1 <= length <= 200email*stringAt most 320 characters. Spaces around it are removed.
emaillength <= 320guests?integer0 <= value <= 100answers?Answers to the event's custom fields, keyed by field key. Text up to 5000 characters (500 for a short-answer question), a number, true or false. At most 100 keys and 100000 characters in all as JSON.
properties <= 100status?stringDefaults to going.
"going""not_going"turnstile_token?stringToken from Cloudflare Turnstile, using the event's turnstile_site_key. Required whenever that key is not null.
1 <= length <= 4096website?stringHoneypot. Leave it out or empty; a value marks the request as a bot.
length <= 2048source?stringWhere the guest RSVPed: embed (the widget, the default) or page (a WhoComing hosted page). Shown to the organizer as the RSVP's source.
"embed""page"The RSVP was created.
application/json- response
id*string^rsvp_[0-9A-Za-z]{6,64}$status*stringwaitlisted is set by WhoComing when the event is full; it cannot be requested directly.
"going""not_going""waitlisted""cancelled"guests*integermanage_token*stringLets the guest view or change this RSVP. Shown once; also emailed.
manage_url*stringcalendar*curl -X POST 'https://api.whocoming.com/v1/public/events/string/rsvps' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "email": "user@example.com"}'{ "id": "string", "status": "going", "guests": 0, "manage_token": "string", "manage_url": "string", "calendar": { "ics_url": "string", "google_url": "string" }}Download the event as a calendar file GET
An iCalendar (.ics) file for "Add to calendar". A cancelled event has `STATUS:CANCELLED`. Private, draft and unknown events answer 404 `event_not_found`. No key needed. CORS is open to any origin. Cached at the CDN for 15 seconds (`s-maxage=15, stale-while-revalidate=60`).
List an organization's upcoming events GET
Upcoming public live-mode events for a calendar, soonest first. Unlisted and private events are left out. An unknown slug and a sandbox organization both answer 404 `not_found`. No key needed. CORS is open to any origin. Cached at the CDN for 15 seconds (`s-maxage=15, stale-while-revalidate=60`).