Create Event

Create Event

curl --request POST \
  --url https://api.example.com/wp-json/latepoint-api/v1/events \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "summary": "<string>",
  "description": "<string>",
  "status": "<string>",
  "event_type": "<string>",
  "online_url": "<string>",
  "category_id": 123,
  "featured_image_id": 123,
  "price": 123,
  "capacity": 123,
  "location_text": "<string>",
  "organizer_name": "<string>",
  "charge_per_ticket": true,
  "ask_ticket_quantity": true,
  "registration_start": "<string>",
  "registration_end": "<string>",
  "order_number": 123,
  "dates": [
    {}
  ],
  "use_ticket_types": true,
  "ticket_types": [
    {}
  ],
  "waiting_list_enabled": true,
  "waiting_list_capacity": 123,
  "waiting_list_capacity_by_type": {}
}
'

import requests

url = "https://api.example.com/wp-json/latepoint-api/v1/events"

payload = {
    "name": "<string>",
    "slug": "<string>",
    "summary": "<string>",
    "description": "<string>",
    "status": "<string>",
    "event_type": "<string>",
    "online_url": "<string>",
    "category_id": 123,
    "featured_image_id": 123,
    "price": 123,
    "capacity": 123,
    "location_text": "<string>",
    "organizer_name": "<string>",
    "charge_per_ticket": True,
    "ask_ticket_quantity": True,
    "registration_start": "<string>",
    "registration_end": "<string>",
    "order_number": 123,
    "dates": [{}],
    "use_ticket_types": True,
    "ticket_types": [{}],
    "waiting_list_enabled": True,
    "waiting_list_capacity": 123,
    "waiting_list_capacity_by_type": {}
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    slug: '<string>',
    summary: '<string>',
    description: '<string>',
    status: '<string>',
    event_type: '<string>',
    online_url: '<string>',
    category_id: 123,
    featured_image_id: 123,
    price: 123,
    capacity: 123,
    location_text: '<string>',
    organizer_name: '<string>',
    charge_per_ticket: true,
    ask_ticket_quantity: true,
    registration_start: '<string>',
    registration_end: '<string>',
    order_number: 123,
    dates: [{}],
    use_ticket_types: true,
    ticket_types: [{}],
    waiting_list_enabled: true,
    waiting_list_capacity: 123,
    waiting_list_capacity_by_type: {}
  })
};

fetch('https://api.example.com/wp-json/latepoint-api/v1/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/wp-json/latepoint-api/v1/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'slug' => '<string>',
    'summary' => '<string>',
    'description' => '<string>',
    'status' => '<string>',
    'event_type' => '<string>',
    'online_url' => '<string>',
    'category_id' => 123,
    'featured_image_id' => 123,
    'price' => 123,
    'capacity' => 123,
    'location_text' => '<string>',
    'organizer_name' => '<string>',
    'charge_per_ticket' => true,
    'ask_ticket_quantity' => true,
    'registration_start' => '<string>',
    'registration_end' => '<string>',
    'order_number' => 123,
    'dates' => [
        [
                
        ]
    ],
    'use_ticket_types' => true,
    'ticket_types' => [
        [
                
        ]
    ],
    'waiting_list_enabled' => true,
    'waiting_list_capacity' => 123,
    'waiting_list_capacity_by_type' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/wp-json/latepoint-api/v1/events"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/wp-json/latepoint-api/v1/events")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/wp-json/latepoint-api/v1/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}"

response = http.request(request)
puts response.read_body

POST

wp-json

latepoint-api

events

Create Event

curl --request POST \
  --url https://api.example.com/wp-json/latepoint-api/v1/events \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "summary": "<string>",
  "description": "<string>",
  "status": "<string>",
  "event_type": "<string>",
  "online_url": "<string>",
  "category_id": 123,
  "featured_image_id": 123,
  "price": 123,
  "capacity": 123,
  "location_text": "<string>",
  "organizer_name": "<string>",
  "charge_per_ticket": true,
  "ask_ticket_quantity": true,
  "registration_start": "<string>",
  "registration_end": "<string>",
  "order_number": 123,
  "dates": [
    {}
  ],
  "use_ticket_types": true,
  "ticket_types": [
    {}
  ],
  "waiting_list_enabled": true,
  "waiting_list_capacity": 123,
  "waiting_list_capacity_by_type": {}
}
'

import requests

url = "https://api.example.com/wp-json/latepoint-api/v1/events"

payload = {
    "name": "<string>",
    "slug": "<string>",
    "summary": "<string>",
    "description": "<string>",
    "status": "<string>",
    "event_type": "<string>",
    "online_url": "<string>",
    "category_id": 123,
    "featured_image_id": 123,
    "price": 123,
    "capacity": 123,
    "location_text": "<string>",
    "organizer_name": "<string>",
    "charge_per_ticket": True,
    "ask_ticket_quantity": True,
    "registration_start": "<string>",
    "registration_end": "<string>",
    "order_number": 123,
    "dates": [{}],
    "use_ticket_types": True,
    "ticket_types": [{}],
    "waiting_list_enabled": True,
    "waiting_list_capacity": 123,
    "waiting_list_capacity_by_type": {}
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    slug: '<string>',
    summary: '<string>',
    description: '<string>',
    status: '<string>',
    event_type: '<string>',
    online_url: '<string>',
    category_id: 123,
    featured_image_id: 123,
    price: 123,
    capacity: 123,
    location_text: '<string>',
    organizer_name: '<string>',
    charge_per_ticket: true,
    ask_ticket_quantity: true,
    registration_start: '<string>',
    registration_end: '<string>',
    order_number: 123,
    dates: [{}],
    use_ticket_types: true,
    ticket_types: [{}],
    waiting_list_enabled: true,
    waiting_list_capacity: 123,
    waiting_list_capacity_by_type: {}
  })
};

fetch('https://api.example.com/wp-json/latepoint-api/v1/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/wp-json/latepoint-api/v1/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'slug' => '<string>',
    'summary' => '<string>',
    'description' => '<string>',
    'status' => '<string>',
    'event_type' => '<string>',
    'online_url' => '<string>',
    'category_id' => 123,
    'featured_image_id' => 123,
    'price' => 123,
    'capacity' => 123,
    'location_text' => '<string>',
    'organizer_name' => '<string>',
    'charge_per_ticket' => true,
    'ask_ticket_quantity' => true,
    'registration_start' => '<string>',
    'registration_end' => '<string>',
    'order_number' => 123,
    'dates' => [
        [
                
        ]
    ],
    'use_ticket_types' => true,
    'ticket_types' => [
        [
                
        ]
    ],
    'waiting_list_enabled' => true,
    'waiting_list_capacity' => 123,
    'waiting_list_capacity_by_type' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/wp-json/latepoint-api/v1/events"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/wp-json/latepoint-api/v1/events")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/wp-json/latepoint-api/v1/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"description\": \"<string>\",\n  \"status\": \"<string>\",\n  \"event_type\": \"<string>\",\n  \"online_url\": \"<string>\",\n  \"category_id\": 123,\n  \"featured_image_id\": 123,\n  \"price\": 123,\n  \"capacity\": 123,\n  \"location_text\": \"<string>\",\n  \"organizer_name\": \"<string>\",\n  \"charge_per_ticket\": true,\n  \"ask_ticket_quantity\": true,\n  \"registration_start\": \"<string>\",\n  \"registration_end\": \"<string>\",\n  \"order_number\": 123,\n  \"dates\": [\n    {}\n  ],\n  \"use_ticket_types\": true,\n  \"ticket_types\": [\n    {}\n  ],\n  \"waiting_list_enabled\": true,\n  \"waiting_list_capacity\": 123,\n  \"waiting_list_capacity_by_type\": {}\n}"

response = http.request(request)
puts response.read_body

All dates and times in the request are in the site timezone. See Dates and times.

Required Parameters

string

required

Event name

Optional Parameters

string

URL slug

string

Short summary

string

Full description. HTML is allowed.

string

default:"draft"

Event status. Available values: draft, published, cancelled, completed

string

default:"in_person"

Event type. Available values: in_person, online

string

Meeting URL for online events

integer

Event category ID. Must be an existing event category.

integer

WordPress media attachment ID to use as the featured image

number

default:"0"

Price per ticket (0 = free event)

integer

default:"0"

Maximum number of places. 0 or empty = unlimited. Negative values are saved as 1.

string

Location shown for the event

string

Organizer shown for the event

boolean

default:"true"

Multiply the price by the number of tickets

boolean

default:"true"

Ask for a ticket quantity in the booking form

string

When registration opens (YYYY-MM-DD HH:MM). null = opens immediately.

string

When registration closes (YYYY-MM-DD HH:MM). null = closes when the event starts.

integer

Display order

array

Event dates. Each item is an object with:

start (required): YYYY-MM-DD HH:MM
end (optional): YYYY-MM-DD HH:MM, must be on or after start. Defaults to start.

Pro Parameters

These parameters require LatePoint Pro Features and are only applied when the corresponding feature (Ticket Types or Waiting List) is enabled in LatePoint settings. Otherwise they are ignored.

boolean

Sell the event through ticket types instead of a single price

array

Ticket types, each with name, price and capacity (0 = unlimited). Send id to keep or update an existing ticket type.This list replaces the event’s ticket types: types you leave out are deleted if they were never sold, otherwise they are set to disabled.

boolean

Enable the waiting list for the event

integer

Maximum number of people in the waiting list (0 = unlimited)

object

Waiting list places per ticket type, as { "ticket_type_id": places }

Example Request

POST /wp-json/latepoint-api/v1/events
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "name": "Yoga Retreat",
  "summary": "Two mornings",
  "status": "published",
  "event_type": "in_person",
  "category_id": 1,
  "price": 25,
  "capacity": 10,
  "location_text": "Studio A",
  "organizer_name": "Ana",
  "ask_ticket_quantity": false,
  "registration_end": "2026-12-01 18:00",
  "dates": [
    { "start": "2026-12-05 09:00", "end": "2026-12-05 12:00" },
    { "start": "2026-12-06 09:00", "end": "2026-12-06 12:00" }
  ],
  "use_ticket_types": true,
  "ticket_types": [
    { "name": "General", "price": 20, "capacity": 8 }
  ],
  "waiting_list_enabled": true,
  "waiting_list_capacity": 5
}

Response

Returns 201 Created with the full event, including dates:

{
  "success": true,
  "message": "Event created successfully",
  "data": {
    "id": 2,
    "name": "Yoga Retreat",
    "slug": "yoga-retreat",
    "summary": "Two mornings",
    "description": null,
    "status": "published",
    "event_type": "in_person",
    "online_url": null,
    "category_id": 1,
    "category": {
      "id": 1,
      "name": "Workshops"
    },
    "featured_image_id": null,
    "featured_image_url": null,
    "location_text": "Studio A",
    "organizer_name": "Ana",
    "price": 25,
    "formatted_price": "$25.00",
    "is_paid": true,
    "charge_per_ticket": true,
    "ask_ticket_quantity": false,
    "start": "2026-12-05 09:00:00",
    "end": "2026-12-06 12:00:00",
    "start_utc": "2026-12-05 12:00:00",
    "end_utc": "2026-12-06 15:00:00",
    "registration_start": null,
    "registration_end": "2026-12-01 18:00:00",
    "registration_open": true,
    "capacity": {
      "unlimited": false,
      "total": 10,
      "booked": 0,
      "available": 10,
      "sold_out": false
    },
    "timezone": "America/Montevideo",
    "order_number": 0,
    "created_at": "2026-10-28 13:05:42",
    "updated_at": "2026-10-28 13:05:42",
    "dates": [
      {
        "id": 1,
        "event_id": 2,
        "start": "2026-12-05 09:00:00",
        "end": "2026-12-05 12:00:00",
        "start_utc": "2026-12-05 12:00:00",
        "end_utc": "2026-12-05 15:00:00"
      },
      {
        "id": 2,
        "event_id": 2,
        "start": "2026-12-06 09:00:00",
        "end": "2026-12-06 12:00:00",
        "start_utc": "2026-12-06 12:00:00",
        "end_utc": "2026-12-06 15:00:00"
      }
    ],
    "use_ticket_types": true,
    "ticket_types": [
      {
        "id": 1,
        "event_id": 2,
        "name": "General",
        "price": 20,
        "formatted_price": "$20.00",
        "capacity": 8,
        "booked": 0,
        "available": 8,
        "sold_out": false,
        "status": "active",
        "order_number": 0
      }
    ],
    "waiting_list": {
      "enabled": true,
      "capacity": 5,
      "queue_count": 0
    }
  }
}

Error Responses

Status	Code	Description
`400`	`missing_field`	`name` is missing
`400`	`invalid_status`	`status` is not one of the allowed values
`400`	`invalid_event_type`	`event_type` is not `in_person` or `online`
`400`	`invalid_dates`	`dates` is not an array, a date has no `start`, or `end` is before `start`
`400`	`invalid_datetime`	A date or time is not in `YYYY-MM-DD HH:MM` format
`400`	`invalid_category`	`category_id` does not match an existing event category
`422`	`save_error`	LatePoint could not save the event
`503`	`feature_disabled`	Events is disabled in LatePoint settings

{
  "code": "invalid_dates",
  "message": "dates[0].end must be on or after its start",
  "data": {
    "status": 400
  }
}

Core Concepts

Bookings

Customers

Agents

Services

Payments

Orders

Coupons

Events

Locations

Availability

System

Required Parameters

Optional Parameters

Pro Parameters

Example Request

Response

Error Responses

​Required Parameters

​Optional Parameters

​Pro Parameters

​Example Request

​Response

​Error Responses

Required Parameters

Optional Parameters

Pro Parameters

Example Request

Response

Error Responses