Skip to content

Register an event

Request

Register a new event in the TickeTing system. Once submitted for review and approved by an administrator, the host can begin to sell tickets to the event.

Security
SessionKey(Required scopes: customeradministrator)
Path
hostintegerrequired

Unique identifier of the requested host

Bodyapplication/json
titlestringrequired

Unique name of the event

descriptionstringrequired

Long form text detailing what the event is about, including performing acts, amenities and additional information important to potential attendees

typestringrequired

Nature of the event. Determines what information is collected on ticket purchase.

Enum:"Standard""Registration"
publicbooleanrequired

Whether or not the event is open to the general public

categorystringrequired

URI of the category under which the event is classified

subcategorystringrequired

Subcategory under which the event is classified

startstring, (date-time)

The date and time at which the event is scheduled to begin

endstring, (date-time)

The date and time at which the event is scheduled to finish

venuestringrequired

URI of the venue at which the event is taking place

disclaimerstring

Subcategory under which the event is classified

tagsArray of strings

List of short phrases that can be used to search and share the event

bannerstring, (base64)

Base64 representation of the event's banner image data

thumbnailstring, (base64)

Base64 representation of the event's thumbnail image data

curl -i -X POST \
  'https://docs.ticketingevents.com/_mock/openapi/hosts/{host}/events' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "title": "Dawn of the Seven Premier",
    "description": "World Premier of the long anticipated movie event of the\nyear: Dawn of the Seven\n",
    "type": "Standard",
    "public": true,
    "category": "/categories/16878141745207",
    "subcategory": "Premier",
    "start": "2024-06-07T20:00:00Z",
    "end": "2024-06-07T23:00:00Z",
    "venue": "/venues/16878146473429",
    "disclaimer": "Attend at your own risk",
    "tags": [
      "homelander",
      "queen maeve",
      "the deep",
      "A-Train"
    ],
    "banner": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAzoAAASRCAYAAAD/zekXAA...",
    "thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAB4AAAAQ4CAYAAADo08FDAAAAB..."
  }'

Responses

The new event was successfully registered.

Bodyapplication/json
selfstring

URI of the event resource

titlestring

Unique name of the event

descriptionstring

Long form text detailing what the event is about, including performing acts, amenities and additional information important to potential attendees

typestring

Nature of the event. Determines what information is collected on ticket purchase.

publicboolean

Whether or not the event is open to the general public

startstring, (date-time)

The date and time at which the event is scheduled to begin

endstring, (date-time)

The date and time at which the event is scheduled to finish

statusstring

Publication status of the event

Enum:"Draft""Pending""Approved""Rejected""Scheduled""Published"
venueobject(response-7)

The location at which the event is taking place

categoryobject(response-8)
subcategoryobject(response-8)
disclaimerstring

Subcategory under which the event is classified

tagsArray of strings

List of short phrases that can be used to search and share the event

publishedstring, (date-time)

The date and time at which the event was first published

popularitynumber

The popularity score of the event. Higher scores indicate greater popularity.

bannerstring, (uri)

URI of the event's banner image

thumbnailstring, (uri)

URI of the event's thumbnail image

Response
{
  "self": "/events/16993717817996",
  "title": "Dawn of the Seven Premier",
  "description": "World Premier of the long anticipated movie event of the\nyear: Dawn of the Seven\n",
  "type": "Standard",
  "public": true,
  "category": {
    "self": "/categories/16878141745207",
    "name": "Party",
    "subcategories": [ … ]
  },
  "subcategory": {
    "self": "/categories/17720402945929",
    "name": "Boat Cruise",
    "subcategories": []
  },
  "start": "2024-06-07T20:00:00Z",
  "end": "2024-06-07T23:00:00Z",
  "status": "Pending",
  "venue": {
    "self": "/venues/16878146473429",
    "name": "Vought Tower",
    "region": { … },
    "longitude": -73.99214,
    "latitude": 40.75518,
    "address": "7th Ave, Manhattan, New York",
    "map": "https://maps.googleapis.com/maps/api/staticmap?center=40.75518,-73.99214&zoom=15&size=600x300&maptype=roadmap&markers=color:red%7C40.75518,-73.99214&key=AIzaSyCyLy8bOLUTLbQLVQFwf1eVO2UIVO8_4kQ&signature=IowClV__Bha7DFVe7TIG-osgyDE="
  },
  "disclaimer": "",
  "tags": [
    "homelander",
    "queen maeve",
    "the deep",
    "A-Train"
  ],
  "published": "2024-02-17T07:32:00Z",
  "popularity": 78,
  "banner": "http://localhost/media/16993717817996-banner.jpeg",
  "thumbnail": "http://localhost/media/16993717817996-thumbnail.jpeg"
}