Skip to content

Register Visitor (Portal) ​

Registers a logged-out visitor for an open event in the FluentCommunity portal, by name and email.

The nonce comes from the portal page (fe_guest_register_<event id>). The visitor is always going and cannot undo it. The confirmation email is queued.

An email that is already on the event is refused, and FluentEvent saves nothing and sends no email. The one exception is a row that said not_going and is linked to no WordPress user: it comes back to going, keeps its name, and fires fluent_event/guest/updated. A row linked to a user changes only from that member's account. A refused request answers HTTP 200 with status: null, a refusal of already_registered or cancelled, and a message that the portal shows as a warning.

When the event has a capacity and every seat is taken, the request is refused with 422.

Endpoint ​

  • Method: POST
  • Path: /fluent-event/v2/community/events/{id}/register-guest
  • Controller: CommunityEventController@registerGuest
  • Route source: fluent-event/app/Http/Routes/api.php:72
  • Controller source: fluent-event/app/Http/Controllers/CommunityEventController.php:221

Permissions ​

  • Logged-out visitors only, on a portal that is open to visitors. The handler also checks the per-event nonce.
  • Rate limit: 5 requests per minute, counted per account for a logged-in user and per IP address for a visitor (RateLimiter::isSpamming('register_guest')). Actions that share a counter name share the limit across every event.

Hooks Fired ​

Live sample

The request and response below were recorded on a running FluentEvent site and then anonymised. Names, emails and event titles are fictional, and long lists are cut to a few items.

Register Visitor (Portal)​

POST
/community/events/{id}/register-guest

Registers a logged-out visitor for an open event in the FluentCommunity portal, by name and email.

Controller: CommunityEventController@registerGuest
Route source: fluent-event/app/Http/Routes/api.php:72

Authorizations​

cookieAuth

Logged-in cookie plus a wp_rest nonce. The browser sends the cookie.

Type
API Key (header: X-WP-Nonce)

Parameters​

Path Parameters

id*

Record ID.

Type
integer
Required
Minimum
1

Request Body​

application/json
JSON
{
  
"nonce": "string",
  
"website": "string",
  
"name": "string",
  
"email": "string"
}

Responses​

Success

application/json
JSON
{
  
"message": "string",
  
"status": "string",
  
"online_meeting_url": "string",
  
"guest_count": 0,
  
"spots_left": "string",
  
"is_full": true
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

FluentEvent developer documentation