Recurring series
One rule, many events. A series creates its occurrences ahead of time so each date has its own guest list.
A series is a repeating event, like "every Friday at 6:30 pm". It is a rule, not a guest list: WhoComing creates a separate event for each date about 90 days ahead, and guests RSVP to those events. Each occurrence has its own ID, capacity count and waitlist.
curl -X POST https://api.whocoming.com/v1/series \
-H "Authorization: Bearer wc_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"title": "Friday Night Magic",
"recurrence": { "frequency": "weekly", "weekday": "friday" },
"timezone": "America/Detroit",
"starts_on": "2027-01-08",
"start_time": "18:30",
"duration_minutes": 210,
"template": { "location_name": "Gotta Gacha", "capacity": 32, "waitlist_enabled": true }
}'Recurrence
recurrence | Means |
|---|---|
{ "frequency": "weekly", "weekday": "friday" } | Every Friday |
{ "frequency": "every_two_weeks", "weekday": "friday" } | Every other Friday, counted from starts_on |
{ "frequency": "monthly", "weekday": "friday", "week_of_month": 2 } | The second Friday of each month |
{ "frequency": "monthly", "weekday": "sunday", "week_of_month": -1 } | The last Sunday of each month |
week_of_month is 1 to 4, or -1 for the last one. The response also carries rrule, the same rule as an iCalendar RRULE, for reference.
Time
start_time is a wall-clock time (HH:MM, 24-hour) in the series timezone, so "6:30 pm" stays 6:30 pm after daylight saving changes. duration_minutes sets each occurrence's end. starts_on is the first possible date; ends_on (optional) the last.
Template
template holds the event settings copied onto every occurrence: location, capacity, waitlist, plus-ones, visibility, price note, cover image and custom fields.
Changing and ending
PATCH /v1/series/{id}changes the fields you send. Changes apply to future occurrences.- To change one date only (a holiday, a special guest), update that occurrence's event with
PATCH /v1/events/{id}. DELETE /v1/series/{id}ends the series: no new occurrences are created. The series is kept withstatus: "ended", and events already created stay, with their guests.
Occurrences carry series_id, so GET /v1/events results can be grouped by series.
The Free plan allows one active series; Starter and Pro allow any number. See plans and limits.