Skip to content

Create Guest ​

Adds a guest to an event by hand (source = manual).

An email or WordPress user that is already on the event is refused with 422. With send_email=true and status going, the confirmation email is queued. The status defaults to going; checked_in also sets checked_in_at.

Endpoint ​

  • Method: POST
  • Path: /fluent-event/v2/events/{eventId}/guests
  • Controller: GuestController@createGuest
  • Route source: fluent-event/app/Http/Routes/api.php:61
  • Controller source: fluent-event/app/Http/Controllers/GuestController.php:35

Permissions ​

  • Requires the manage_options capability (a site administrator). FluentEvent has no separate staff roles: its admin API is for administrators only.

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.

Create Guest​

POST
/events/{eventId}/guests

Adds a guest to an event by hand (source = manual).

Controller: GuestController@createGuest
Route source: fluent-event/app/Http/Routes/api.php:61

Authorizations​

ApplicationPasswords

A WordPress username and an Application Password.

Type
HTTP (basic)

Parameters​

Path Parameters

eventId*

Event ID (fe_event_details.id).

Type
integer
Required
Minimum
1

Request Body​

application/json
JSON
{
  
"send_email": true,
  
"name": "string",
  
"email": "string",
  
"status": "string",
  
"user_id": 0
}

Responses​

Success

application/json
JSON
{
  
"message": "string",
  
"guest": {
  
  
"event_id": 0,
  
  
"calendar_id": 0,
  
  
"name": "string",
  
  
"email": "string",
  
  
"user_id": 0,
  
  
"status": "string",
  
  
"checked_in_at": "string",
  
  
"group_id": "string",
  
  
"is_buyer": 0,
  
  
"source": "string",
  
  
"updated_at": "string",
  
  
"created_at": "string",
  
  
"id": 0,
  
  
"avatar": "string"
  
}
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI

FluentEvent developer documentation