Events · Hosts
Hosting an event (#2483): start and edit it, its days and Fundly shares, ticket types, co-hosts, volunteers, sponsors, photos and recap, submit, duplicate, postpone and cancel; and the caller's own lists. An event's routes are for its accepted hosts (whoever acts for an accepted host row: the member, a non-profit or church's owners and admins, a community's owner and leaders, a sponsor's owner and admins) and staff with manage_events; anyone else gets 404. A rule's refusal is 409 not_allowed with details.reason, the same i18n key the page's viewer block shows. Behind features.events.
Start an event (a draft)
A new draft with its main host: an identity the caller acts for (host: themselves, a non-profit or church they manage, a community they lead, a sponsor they own; themselves when left out). FundlyHub is never automatically added. A super administrator or ambassador can explicitly select {kind: platform, id: null}. Only a super administrator may select another identity with accept_without_invitation: true. time_zone is required; anything else already typed may come along. A free event gets its RSVP ticket type. The link is made from the title when not given.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Request Body
Responses
The draft.
Delete a draft
An event that never went live (draft, changes requested or rejected). It is kept, marked deleted, and answers 404 from then on.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
Done.
Edit an event
Saved as the host types. Editable until the event ends (not when rejected, cancelled, or, for hosts, suspended). A venue sets the city to the venue's. On a live event a changed place is published as event.rescheduled; a live event must keep a title and a place. Answers with the page.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The page after the change.
Check an event link
May this event use the link: not invalid, not reserved, not another event's (now or before). The event's own earlier links are free for it.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Query Parameters
Responses
The answer.
Save the days
The whole list (at most 14), each ending after it starts; sorted by start. A day keeps its id when the list names it. Removing a day a ticket type is for answers 409 day_in_use. A live event keeps at least one day; a changed date or time on it is published as event.rescheduled.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The days.
Save the Fundlies and their shares
The whole list: 1 to 10 Fundlies, whole-percent shares of 1 to 100, adding up to no more than 100, exactly 100 on a live event (shares_must_total_100). A Fundly newly linked must be live and taking gifts (fundraiser_not_open, details.fundraiser_ids). Other refusals: too_many_fundraisers, duplicate_fundraiser, share_out_of_range, shares_over_100.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The shares.
Submit for review
Needs a verified email, a title, a date, a place (a venue, online, or to be announced), Fundly shares adding up to 100 and a ticket type (event_incomplete, details.problems are i18n keys). Hosts send it to staff review (event.submitted); staff with manage_events publish it at once (event.approved, not reviewed).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
The new status.
Duplicate an event
A new draft with the event's details, days, Fundly shares, ticket types (not stopped or code-only ones) and volunteer roles, hosted by the host the caller acts for.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
The copy.
Postpone a live event
With new days, or none for "new date coming". Tickets stay valid. Published as event.postponed.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The page.
Cancel a live event
Sales stop and the page says it is cancelled; it stays up so shared links still explain. Published as event.cancelled. Refunds arrive with tickets (phase 6).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
The page.
Add a ticket type
At most 20. A free event's types are $0 (free_event_price); the value of the dinner is at most the price; "only with a code" needs access_code; "members of a host community" needs a community host (no_host_community); a "one day each" event gives each type its day (day_required, unknown_day).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The type.
Delete a ticket type
Only one that never sold (ticket_type_has_sales); a free event keeps one open RSVP type (rsvp_type_required).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The ticket type.
"uuid"Responses
Done.
Change a ticket type
Only while it has sold nothing (ticket_type_has_sales) and is not stopped (ticket_type_stopped); the same rules as adding.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The ticket type.
"uuid"Request Body
Responses
The type.
Stop selling a ticket type
Its tickets stay valid. The way to end a type that has sold.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The ticket type.
"uuid"Responses
The type.
Save the co-host list
The editor's whole host list, including any explicitly selected platform row, saved atomically by draft autosave or live Save changes. Omitted rows are removed; existing rows keep their status unless a super administrator explicitly accepts a pending invitation with accept_without_invitation: true. Adding platform requires super_admin or ambassador; an authorized editor can keep or remove an existing platform row. Non-staff must keep one accepted host (last_host). Invitations and acceptance events are sent only after commit, once; repeating the saved list sends no duplicate invitation or acceptance.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
What the save changed.
Invite a co-host
A member, non-profit or church, community or sponsor business. It shows on the page once it accepts (event_host.invited); one the caller acts for is added accepted at once (event_host.accepted). An explicit super-admin override accepts immediately without sending an invitation. Only a super administrator or ambassador can add FundlyHub as an explicit platform host. A declined host can be invited again. At most 10.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The host row.
Remove a co-host
An authorized editor can remove any host including an explicit FundlyHub row; the event keeps one accepted host (last_host, staff excepted).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The host row.
"uuid"Responses
Done.
The Volunteers tab
The roles with filled and open slots, and everyone in them.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
Roles and volunteers.
Add a volunteer role
At most 30.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The role.
Delete a volunteer role
With everyone in it.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The role.
"uuid"Responses
Done.
Change a volunteer role
Slots never drop below the people confirmed (slots_below_confirmed).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The role.
"uuid"Request Body
Responses
The role.
Add a volunteer
A member (profile_id, invited) or someone without an account (name and email, confirmed; role_full when every slot is filled).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The role.
"uuid"Request Body
Responses
The volunteer.
Remove a volunteer
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The volunteer.
"uuid"Responses
Done.
Change a volunteer
Name, email, phone and note.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The volunteer.
"uuid"Request Body
Responses
The volunteer.
Approve a sign-up
A requested sign-up becomes confirmed (not_requested, role_full).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The volunteer.
"uuid"Responses
The volunteer.
Decline a sign-up or an invitation
not_pending otherwise.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The volunteer.
"uuid"Responses
The volunteer.
The Sponsors tab
Every sponsor, with the hosts' bookkeeping, and the requests from the page, newest first.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
Sponsors and requests.
Add a sponsor
At most 50; one presenting sponsor (presenting_sponsor_taken); each FundlyHub partner once (sponsor_already_added); a partner the candidate search would not show is not_found.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The sponsor.
Reorder the sponsors
Every sponsor id once, in the new order (order_mismatch).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The sponsors.
Remove a sponsor
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The sponsor row.
"uuid"Responses
Done.
Change a sponsor
A FundlyHub partner's name, logo and page come from its own page (fundlyhub_sponsor_profile).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The sponsor row.
"uuid"Request Body
Responses
The sponsor.
Delete a sponsor request
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The request.
"uuid"Responses
Done.
Answer a sponsor request
Mark it replied, added or dismissed. Stays open after the event.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The request.
"uuid"Request Body
Responses
The request.
The gallery
Every photo, those to review and hidden too.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Responses
Photos.
Add a photo
Uploaded with POST /storage/upload. Hosts add it shown (optionally as the cover); a confirmed volunteer in a role that may upload photos may add one too, and it waits as to_review. At most 200.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The photo.
Reorder the gallery
Every photo id once, in the new order (order_mismatch).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
Photos.
Delete a photo
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The photo.
"uuid"Responses
Done.
Show, hide or make the cover
The cover is one shown photo (cover_must_show); only a hidden photo has a reason (reason_for_hidden_only).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"The photo.
"uuid"Request Body
Responses
The photo.
Write the recap
Any time a live event is not cancelled; published once it has ended.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The recap.
Publish the recap
Once the event has ended (not_allowed, events.viewer.reasons.not_ended before). Published as event.recap_published, with whether to email the guests.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The event's id.
"uuid"Request Body
Responses
The page.
Accept a co-host invitation
By someone who acts for the invited host. The host then shows on the page (event_host.accepted).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The invitation (host row).
"uuid"Responses
Accepted.
Decline a co-host invitation
By someone who acts for the invited host.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Path Parameters
The invitation (host row).
"uuid"Responses
Declined.
Your events
Hosting: every event (any state but deleted) with an accepted host the caller acts for, latest first (items); with as, only the events that one identity hosts (a workspace's Events tab, #2494). Going (#2487): every event the caller holds tickets for, as the buyer or a guest named on a ticket, as upcoming (soonest first) and past (latest first), each row with their tickets.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Query Parameters
"hosting""going""hosting"Responses
Rows.
Co-host invitations for you
Invitations naming the caller or a non-profit, church, community or sponsor they act for, newest first; with as, only those naming that one identity (#2494). Each invitation also reaches the people who can answer it as a bell notice and an email (event_host_invited, metadata hostId).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Responses
Invitations.
Find an Event member, co-host or sponsor identity
A fresh authenticated identity lookup for Event editors. Names and profile handles are searched directly; no email or private biography is searched or returned. Inactive/deleting members are excluded. Sponsor choices do not require discoverable perks: public sponsor pages are available, while private applications require current sponsor-team or sponsor-specific staff authority. Returned identity fields are minimal. Responses use private, no-store caching and vary by Cookie and Authorization.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Parameters
Query Parameters
Fewer than two characters return no choices.
80"all""member""organization""community""sponsor""all"12010Responses
Matching identities, without private contact or sponsor bookkeeping fields.
Who you can host as
The identities the caller can host an event as (#2494): themself, and each non-profit, church, community and sponsor business they act for; staff publishing access and separate strict role-based host capabilities. Platform choice is for super administrators or ambassadors; consent override is for super administrators only. The app shows its Events tabs and "Host an event" only once this answers 200: a 404 means Events are switched off for the caller.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Responses
Identities.
Saved venues
The open premises (with an address) of the non-profits, churches, communities and sponsors the caller acts for, to pick as a venue (venue_place_id).
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Responses
Venues.