Skip to Content
Public

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.

POST
/v1/public/events/{id}/rsvps

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.

Path Parameters

id*string
Match^evt_[0-9A-Za-z]{6,64}$

Header Parameters

idempotency-key?string

Send 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.

Length1 <= length <= 255

Request Body

application/json
  1. body
name*string
Length1 <= length <= 200
email*string

At most 320 characters. Spaces around it are removed.

Formatemail
Lengthlength <= 320
guests?integer
Range0 <= value <= 100
answers?

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.

Propertiesproperties <= 100
status?string

Defaults to going.

Value in"going""not_going"
turnstile_token?string

Token from Cloudflare Turnstile, using the event's turnstile_site_key. Required whenever that key is not null.

Length1 <= length <= 4096
website?string

Honeypot. Leave it out or empty; a value marks the request as a bot.

Lengthlength <= 2048
source?string

Where the guest RSVPed: embed (the widget, the default) or page (a WhoComing hosted page). Shown to the organizer as the RSVP's source.

Value in"embed""page"

Response Body

The RSVP was created.

application/json
  1. response
id*string
Match^rsvp_[0-9A-Za-z]{6,64}$
status*string

waitlisted is set by WhoComing when the event is full; it cannot be requested directly.

Value in"going""not_going""waitlisted""cancelled"
guests*integer
manage_token*string

Lets the guest view or change this RSVP. Shown once; also emailed.

manage_url*string
calendar*
Example Request
curl -X POST 'https://api.whocoming.com/v1/public/events/string/rsvps' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "email": "user@example.com"}'
Example Response
{  "id": "string",  "status": "going",  "guests": 0,  "manage_token": "string",  "manage_url": "string",  "calendar": {    "ics_url": "string",    "google_url": "string"  }}