--- title: "Publish an event" method: POST path: "/publish/v2/events" --- # Publish an event `POST /publish/v2/events` Since 1.0.0 ## Headers - `TMPS-Correlation-Id` string, required ## Request body - Event — Event - `type` 'event' | 'venue' | 'attraction', required — Type of the entity - `distance` number, double - `units` string - `location` Location — Location - `longitude` number — Longitude - `latitude` number — Latitude - `source` Source — Source - `name` string — Source's name - `id` string — ID of the entity in the source's system - `names` object — Names of the entity - multi-lingual fields - `descriptions` object — Descriptions of the entity - multi-lingual fields - `additionalInfos` object — Additional informations of the entity - multi-lingual fields - `url` string — URL of a web site detail page of the entity - `images` Image[] — Images of the entity - `url` string — Public URL of the image - `ratio` '16_9' | '3_2' | '4_3' — Aspect ratio of the image - `width` integer — Width of the image - `height` integer — Height of the image - `fallback` boolean — true if the image is not the event's image but a fallbak image - `domains` string[] — Domains on which this image should be displayed - `attribution` string — Attribution of the image - `publicVisibility` PublicVisibility — The class defines the public visibility period on the Discovery/Publish API. - `startDateTime` string, date-time — The start of the public visibility. The date and time when the event will be public visible - `endDateTime` string, date-time — The end of the public visibility. The date and time when the event will be public visible - `visible` boolean — True if you want to have the event visible in the discovery API - `dates` EventDates — Event's Dates - `start` StartDates — Event's Start Dates - `localDate` string, date — The event start date in local date - `localTime` LocalTime - `chronology` Chronology - `zone` DateTimeZone - `id` string - `fixed` boolean - `millisOfDay` integer - `minuteOfHour` integer - `hourOfDay` integer - `millisOfSecond` integer - `secondOfMinute` integer - `fields` DateTimeField[] - `name` string - `type` DateTimeFieldType - `name` string - `durationType` DurationFieldType - … - `rangeDurationType` DurationFieldType - … - `supported` boolean - `lenient` boolean - `durationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `minimumValue` integer - `maximumValue` integer - `rangeDurationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `leapDurationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `values` integer[] - `fieldTypes` DateTimeFieldType[] - `name` string - `durationType` DurationFieldType - `name` string - `rangeDurationType` DurationFieldType - `name` string - `dateTime` string, date-time — The event start datetime - `dateTBD` boolean — Boolean flag to indicate whether or not the start date is TBD - `dateTBA` boolean — Boolean flag to indicate whether or not the start date is TBA - `timeTBA` boolean — Boolean flag to indicate whether or not the start time is TBA - `noSpecificTime` boolean — Boolean flag to indicate whether or not the event has no specific time - `end` EndDates — Event's End Dates - `localTime` LocalTime - `chronology` Chronology - `zone` DateTimeZone - `id` string - `fixed` boolean - `millisOfDay` integer - `minuteOfHour` integer - `hourOfDay` integer - `millisOfSecond` integer - `secondOfMinute` integer - `fields` DateTimeField[] - `name` string - `type` DateTimeFieldType - `name` string - `durationType` DurationFieldType - … - `rangeDurationType` DurationFieldType - … - `supported` boolean - `lenient` boolean - `durationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `minimumValue` integer - `maximumValue` integer - `rangeDurationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `leapDurationField` DurationField - `name` string - `type` DurationFieldType - … - `supported` boolean - `precise` boolean - `unitMillis` integer - `values` integer[] - `fieldTypes` DateTimeFieldType[] - `name` string - `durationType` DurationFieldType - `name` string - `rangeDurationType` DurationFieldType - `name` string - `dateTime` string, date-time — The event end date time - `approximate` boolean — Boolean flag to indicate whether or not the end date is approximated - `access` AccessDates — Event's Access Date - `startDateTime` string, date-time — Event's start access time - `startApproximate` boolean — Boolean flag to indicate whether or not the access start date is approximated - `endDateTime` string, date-time — Event's end access time - `endApproximate` boolean — Boolean flag to indicate whether or not the access end date is approximated - `timezone` string — Event's timezone - `status` EventStatus — Event's Status - `code` 'onsale' | 'offsale' | 'canceled' | 'postponed' | 'rescheduled' — The event's status code - `sales` EventSalesDates — Event's Sales Dates - `public` PublicSaleDates — Event's Public Onsales Dates - `startDateTime` string, date-time — Public sale's start dates. The date and time when the public sale will start - `endDateTime` string, date-time — Public sale's end dates. The date and time when the public sale will end - `startTBD` boolean — True if the public sale's date is to be determined - `presales` Presale[] — Presale information on this event - `names` object — Name of the presale - multi-lingual fields - `descriptions` object — Description of the presale - multi-lingual fields - `url` string — Presale link URL - `startDateTime` string, date-time — Presale's start dates. The date and time when the presale will start - `endDateTime` string, date-time — Presale's end dates. The date and time when the presale will end - `infos` object — Any information related to the event - multi-lingual fields - `pleaseNotes` object — Any notes related to the event - multi-lingual fields - `priceRanges` PriceRange[] — Price ranges of this event - `type` 'standard' — Type of price - `currency` string — Currency - `min` number, double — Minimum price - `max` number, double — Maximum price - `promoter` Promoter — Promoter - `id` string — Id of the promoter - `names` object — Name of the promoter - multi-lingual fields - `descriptions` object — Description of the promoter - multi-lingual fields - `classifications` Classification[] — Event's classifications - `primary` boolean - `segment` Segment — Segment - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `genre` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `subGenre` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `type` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `subType` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `place` Place — Place - `area` Area — Area - `names` object — Names of the entity - multi-lingual fields - `address` Address — Address - `line1s` object — Aaddress first line - multi-lingual fields - `line2s` object — Address second line - multi-lingual fields - `line3s` object — Address third line - multi-lingual fields - `city` City — City - `names` object — Names of the entity - multi-lingual fields - `state` State — State - `stateCode` string — State code - `names` object — Names of the entity - multi-lingual fields - `country` Country — Country - `countryCode` string — Country code (ISO 3166) - `names` object — Names of the entity - multi-lingual fields - `postalCode` string — Postal code / zipcode of the place - `location` Location — Location - `longitude` number — Longitude - `latitude` number — Latitude - `names` object — Names of the entity - multi-lingual fields - `venue` Venue — Venue - `type` 'event' | 'venue' | 'attraction', required — Type of the entity - `distance` number, double - `units` string - `source` Source — Source - `name` string — Source's name - `id` string — ID of the entity in the source's system - `names` object — Names of the entity - multi-lingual fields - `address` Address — Address - `line1s` object — Aaddress first line - multi-lingual fields - `line2s` object — Address second line - multi-lingual fields - `line3s` object — Address third line - multi-lingual fields - `descriptions` object — Descriptions of the entity - multi-lingual fields - `city` City — City - `names` object — Names of the entity - multi-lingual fields - `state` State — State - `stateCode` string — State code - `names` object — Names of the entity - multi-lingual fields - `additionalInfos` object — Additional informations of the entity - multi-lingual fields - `country` Country — Country - `countryCode` string — Country code (ISO 3166) - `names` object — Names of the entity - multi-lingual fields - `url` string — URL of a web site detail page of the entity - `postalCode` string — Postal code / zipcode of the venue - `location` Location — Location - `longitude` number — Longitude - `latitude` number — Latitude - `timezone` string — Timezone of the venue - `currency` string — Default currency of ticket prices for events in this venue - `markets` Market[] — Markets of the venue - `id` string — Market's id - `images` Image[] — Images of the entity - `url` string — Public URL of the image - `ratio` '16_9' | '3_2' | '4_3' — Aspect ratio of the image - `width` integer — Width of the image - `height` integer — Height of the image - `fallback` boolean — true if the image is not the event's image but a fallbak image - `domains` string[] — Domains on which this image should be displayed - `attribution` string — Attribution of the image - `dma` Dma[] — The list of associated DMAs (Designated Market Areas) of the venue - `id` integer — DMS's id - `social` Social — Social networks data - `twitter` Twitter — Twitter data - `handle` '@a Twitter handle' — Twitter handle - `hashtags` string[] — Twitter hashtags - `boxOfficeInfo` VenueBoxOfficeInfo — Venue box office information - `phoneNumberDetails` object — Venue box office phone number - multi-lingual fields - `openHoursDetails` object — Venue box office opening hours - multi-lingual fields - `acceptedPaymentDetails` object — Venue box office accepted payment details - multi-lingual fields - `willCallDetails` object — Venue box office will call details - multi-lingual fields - `parkingDetails` object — Venue parking info - multi-lingual fields - `accessibleSeatingDetails` object — Venue accessible seating details - multi-lingual fields - `generalInfo` VenueGeneralInfo — Venue general information - `generalRules` object — Venue general rules - multi-lingual fields - `childRules` object — Venue children rules - multi-lingual fields - `relationships` Relationship[] — Relationships on the entity, like if the entity is a duplicate of another one - `references` object — References of this entity in an other system. Reference is the exact same entity - `version` integer — Version of the entity. Version is to avoid updated an entity with an older version - `active` boolean — Indicate if the entity is active, inactive entity won't appear in Discovery API - `test` boolean — Indicate if this is a test entity, by default test entities won't appear in discovery API - `discoverable` boolean — True if the entity is dicoverable in discovery API - `attractions` Attraction[] — Ordered Attraction related to the event - `type` 'event' | 'venue' | 'attraction', required — Type of the entity - `source` Source — Source - `name` string — Source's name - `id` string — ID of the entity in the source's system - `names` object — Names of the entity - multi-lingual fields - `descriptions` object — Descriptions of the entity - multi-lingual fields - `additionalInfos` object — Additional informations of the entity - multi-lingual fields - `url` string — URL of a web site detail page of the entity - `images` Image[] — Images of the entity - `url` string — Public URL of the image - `ratio` '16_9' | '3_2' | '4_3' — Aspect ratio of the image - `width` integer — Width of the image - `height` integer — Height of the image - `fallback` boolean — true if the image is not the event's image but a fallbak image - `domains` string[] — Domains on which this image should be displayed - `attribution` string — Attribution of the image - `classifications` Classification[] — Attraction's classifications - `primary` boolean - `segment` Segment — Segment - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `genre` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `subGenre` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `type` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `subType` Level - `id` string — The ID of the classification's level - `names` object — The Name of the classification's level - multi-lingual fields - `relationships` Relationship[] — Relationships on the entity, like if the entity is a duplicate of another one - `references` object — References of this entity in an other system. Reference is the exact same entity - `version` integer — Version of the entity. Version is to avoid updated an entity with an older version - `active` boolean — Indicate if the entity is active, inactive entity won't appear in Discovery API - `test` boolean — Indicate if this is a test entity, by default test entities won't appear in discovery API - `discoverable` boolean — True if the entity is dicoverable in discovery API - `relationships` Relationship[] — Relationships on the entity, like if the entity is a duplicate of another one - `references` object — References of this entity in an other system. Reference is the exact same entity - `version` integer — Version of the entity. Version is to avoid updated an entity with an older version - `active` boolean — Indicate if the entity is active, inactive entity won't appear in Discovery API - `test` boolean — Indicate if this is a test entity, by default test entities won't appear in discovery API - `discoverable` boolean — True if the entity is dicoverable in discovery API ## Response `200` successful operation --- [API](https://skmtc.net/ticketmaster-api/apis/ticketmaster-publish-api.md) · [All operations](https://skmtc.net/ticketmaster-api/apis/ticketmaster-publish-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ticketmaster-api/ticketmaster-publish-api/revisions/109dd23e9174/schema)