Skip to Content

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

recurrenceMeans
{ "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 with status: "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.

On this page