Events · VIP guests
VIP guests (#2709): complimentary seats inside the event's capacity, out of the hosts' reserve (vip_reserved_seats) first, then out of public seats if any remain. The hosts send a ticket at once or invite the guest to confirm, by email or by a personal short link (https://fundlyhub.org/i/<code>, 10 characters without 0 O 1 l I) they send themselves; a phone number is never sent to the server. The guest answers by the link alone: rate limited, Referrer-Policy: no-referrer, never cached or indexed, and GET changes nothing. Behind features.events.
VIP guests
Every VIP guest of the event, newest first, and where the reserve stands. Hosts and staff (as Add people).
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 invites and the reserve.
Add a VIP guest
Complimentary seats (1-20) for a member (profile_id) or a name. delivery: ticket confirms at once and issues the order; invite holds the seats until the guest confirms or declines, or until respond_by (else the event's start). The email goes when send_email is not false and there is an address (email, else the member's account email); a guest with neither gets the link only. uses_public_seats: how many of the seats came out of public sale because the reserve was used up. 409 not_allowed (events.orders.reasons.not_enough_seats, details.left) when they do not fit. Honours Idempotency-Key. Audited.
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
Header Parameters
Optional (#2709): 16 to 200 of [A-Za-z0-9_.:-], a uuid. Kept two days, scoped to the endpoint, the event and the caller.
"^[A-Za-z0-9_.:-]{16,200}$"Path Parameters
The event's id.
"uuid"Request Body
Responses
Added.
Add many VIP guests
Up to 200 VIP guests at once (#2716) with the settings of one VIP add: each row is added in order by the single add, in its own transaction, never all or nothing; a row that does not fit or is invalid is reported and the rest are still added. A row with an email (a member's is their account's) is emailed unless send_email is false; every invite carries its link, which the hosts send to those without an email. uses_public_seats: the batch's seats that came out of public sale. A refusal about the settings (respond_by_past, unknown_ticket_type, ...) stops the batch as in Add many people. With Idempotency-Key each row is kept under <key>:bulk:<index>: a retried batch adds nobody twice. Rate limited per account: ten batches in ten minutes, with Add many people.
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
Header Parameters
Optional (#2709): 16 to 200 of [A-Za-z0-9_.:-], a uuid. Kept two days, scoped to the endpoint, the event and the caller.
"^[A-Za-z0-9_.:-]{16,200}$"Path Parameters
The event's id.
"uuid"Request Body
Responses
Each row's result, in order.
Revoke a VIP guest
Status revoked: the link stops working, a going guest's order is cancelled (free) and the seats go back. Refused once part of the party checked in.
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""uuid"Responses
Revoked.
Change a VIP guest's seats or date to answer by
A pending invite's hold follows its seats (more must fit). A going guest's party is lowered with them, cancelling the highest seats nobody checked in (never below those who did, 409 events.invites.reasons.below_checked_in); a ticket the host sent follows them up too, while an invited guest may raise their own party up to the new number.
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""uuid"Request Body
Responses
Changed.
A new link
A new link code; the old link stops working (404 invite_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""uuid"Responses
The invite with its new link.
Add an email
Saves the address and sends what the invite's state calls for (the invitation while pending, the ticket while going).
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""uuid"Request Body
Responses
Saved.
A VIP guest's invitation, by their link
The event, the invitation, the ticket once going, and the personalized link preview (Open Graph) in the invite's language. Changes nothing. An unknown, replaced or revoked code is 404 invite_not_found; a revoked one's carries details.host_name, whom to ask for a new link.
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Query Parameters
The preview's language (else the invite's).
"en""ru""uk""es"Responses
The invitation.
Confirm N seats
Makes the complimentary order for party_size (1 to the seats given); the seats not taken go back to the reserve; the ticket is emailed when there is an address. Again with the same size: the same ticket; another size changes the party. After a decline: while the time to answer lasts and the seats are there.
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Request Body
Responses
The ticket.
Can't make it
While pending (a going guest releases instead); the seats go back. keep_posted is "Keep me posted about future events".
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Request Body
Responses
Declined.
Change guests
A going guest lowers their party, or raises it back up to the seats given when capacity allows; never below the seats already checked in.
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Request Body
Responses
The ticket.
Release my seats
A going guest gives every seat back; the order is cancelled and the invite released. Refused once part of the party checked in.
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Responses
Released.
Get updates by email
Only while no email is on file (409 events.invites.reasons.email_on_file); a going guest's ticket is sent there.
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 link's code (10 characters without 0 O 1 l I).
"^[2-9a-km-zA-HJ-NP-Z]{10}$"Request Body
Responses
Saved.