Create an event
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.
bearerAuthAuthorizationBearer <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.
application/json- body
title*stringstart_datetime*stringdate-timeend_datetime?stringdate-timecapacity*integer1 <= valueticket_price*number0 <= valuedescription?stringPlain text. Converted to HTML for display.
description_html?stringSanitised server-side before storage.
event_type?EventType"concert""workshop""conference""sports""social""food""nightlife""art""other"venue_name?stringaddress?stringGeocoded when latitude/longitude are absent.
city?stringlatitude?numberMust be sent with longitude.
longitude?numberMust be sent with latitude.
is_online?booleanfalsecover_image_url?stringThe created event.
application/json- response
data?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}'{ "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 } ] }}Create a checkout POST
Returns a hosted `checkout_url` to send the buyer to. Inventory is held only until `expires_at`. For a reserved-seating event, pass `section_id` (from `GET /events/{id}/sections`); omitting it is a 400 rather than a general-admission fallback. The seats the buyer was given come back in `assigned_seats`.
Create a promo code POST
Next Page