Create an event

POST
/events

A venue event needs coordinates. Send latitude and longitude, or an address that geocodes — if geocoding is unavailable and no coordinates were sent, the request is rejected rather than stored without a location.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Authorization: Bearer hh_live_.... Create and revoke keys in Organizer → Settings → API. A key carries full access to its partner's data, including refunds and promo codes — treat it as a production credential and keep it server-side.

Request Body

application/json
  1. body
title*string
start_datetime*string
Formatdate-time
end_datetime?string
Formatdate-time
capacity*integer
Range1 <= value
ticket_price*number
Range0 <= value
description?string

Plain text. Converted to HTML for display.

description_html?string

Sanitised server-side before storage.

event_type?EventType
Value in"concert""workshop""conference""sports""social""food""nightlife""art""other"
venue_name?string
address?string

Geocoded when latitude/longitude are absent.

city?string
latitude?number

Must be sent with longitude.

longitude?number

Must be sent with latitude.

is_online?boolean
Defaultfalse
cover_image_url?string

Response Body

The created event.

application/json
  1. response
data?
Example Request
curl -X POST 'https://hanghut.com/api/v1/events' \  -H 'Content-Type: application/json' \  -d '{  "title": "string",  "start_datetime": "2019-08-24T14:15:22Z",  "capacity": 1,  "ticket_price": 0}'
Example Response
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "title": "string",    "status": "draft",    "start_datetime": "2019-08-24T14:15:22Z",    "end_datetime": "2019-08-24T14:15:22Z",    "is_online": true,    "venue_name": "string",    "address": "string",    "city": "string",    "capacity": 0,    "cover_image_url": "string",    "ticket_price": 0,    "event_type": "concert",    "tickets_sold": 0,    "ticket_tiers": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "price": 0,        "quantity_total": 0,        "quantity_sold": 0,        "is_active": true,        "sort_order": 0      }    ]  }}