Participants

Register a participant

Anonymous-friendly. Works without an Authorization header — the link-share viral loop preserved. Anonymous calls are rate-limited per IP using the anon tier (600/min reads, 6/min writes, 10,000/day). Authenticated calls use the credential's tier as usual.

post/signups/{id}/participants

Request

  • Base URL: https://thesignup.app/api/v1
  • URL: https://thesignup.app/api/v1/signups/{id}/participants
  • Auth: none required

Path parameters

idstring uuid required

Request body

namestring required
emailstring email required
phonestring
eventCustomFieldResponsestring
dayCustomFieldResponsesobject

Answers to Day Questions, keyed by event day id. A Required Day Question must be answered for every day the registration touches (a slot on it, an item scoped to it, or day attendance) or the request is refused with 400 naming the question. On a repeat registration the map is merged by key over what is already held; a blank value clears that day's answer.

attendDayIdsstring[]

Event day ids the participant is attending, beyond the days implied by their slots. Written with the registration; a day of another signup, a cancelled day, or a day on a commitment-required signup is refused with 400.

Response

Registration created

successboolean required
confirmationTokenstring

Returned to the participant so they can later edit/cancel their registration without re-authenticating. Show it in the success page; agents should preserve it. Present for a new registration, and for a repeat registration only when the caller's credential belongs to the organization that owns the signup. Otherwise — an anonymous or foreign-org repeat for an email already registered — the response carries no token and success: false, nothing is changed, and the manage link is emailed to the address on file.

Changes

No recorded changes to this operation across all 1 revision of this API.