Skip to content

Create Event ​

Creates an event: the fe_event post and its fe_event_details row, in one transaction.

Send start_at and end_at as local date-times (Y-m-d H:i:s) in timezone. An empty or invalid timezone falls back to the site's. end_at must be after start_at.

online_meeting_url is required when venue_type is online; venue and address are cleared for an online event, and online_meeting_url for an offline one. Reminder emails are queued for the new event.

Endpoint ​

  • Method: POST
  • Path: /fluent-event/v2/events
  • Controller: EventController@createEvent
  • Route source: fluent-event/app/Http/Routes/api.php:56
  • Controller source: fluent-event/app/Http/Controllers/EventController.php:104

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 Event​

POST
/events

Creates an event: the fe_event post and its fe_event_details row, in one transaction.

Controller: EventController@createEvent
Route source: fluent-event/app/Http/Routes/api.php:56

Authorizations​

ApplicationPasswords

A WordPress username and an Application Password.

Type
HTTP (basic)

Request Body​

application/json
JSON
{
  
"calendar_id": 0,
  
"title": "string",
  
"description_md": "string",
  
"status": "string",
  
"start_at": "string",
  
"end_at": "string",
  
"timezone": "string",
  
"venue_type": "string",
  
"cover_url": "string",
  
"online_meeting_url": "string",
  
"venue": "string",
  
"address": "string",
  
"entry_type": "string",
  
"show_guest_count": "string",
  
"capacity": 0,
  
"show_spots_left": "string",
  
"start_display": "string"
}

Responses​

Success

application/json
JSON
{
  
"message": "string",
  
"event": {
  
  
"post_id": 0,
  
  
"calendar_id": 0,
  
  
"parent_event_id": "string",
  
  
"status": "string",
  
  
"start_at": "string",
  
  
"end_at": "string",
  
  
"timezone": "string",
  
  
"venue_type": "string",
  
  
"meta": {
  
  
  
"cover_url": "string",
  
  
  
"online_meeting_url": "string",
  
  
  
"venue": "string",
  
  
  
"address": "string",
  
  
  
"entry_type": "string",
  
  
  
"show_guest_count": "string",
  
  
  
"capacity": 0,
  
  
  
"show_spots_left": "string",
  
  
  
"start_display": "string",
  
  
  
"description_md": "string"
  
  
},
  
  
"updated_at": "string",
  
  
"created_at": "string",
  
  
"id": 0,
  
  
"title": "string",
  
  
"start_at_local": "string",
  
  
"end_at_local": "string",
  
  
"start_at_site": "string",
  
  
"end_at_site": "string"
  
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

FluentEvent developer documentation