Add Event Endpoint

Resellers are required to add their events to the Tixstock system by using the add event endpoint. This will allow the brokers within Tixstock to list inventory for your event.

The endpoint will attempt to 'event map' your event details to an event already populated from within the Tixstock system.

If no event can be mapped, the event details provided will be inserted as a new event into the Tixstock system.

Endpoint URL

https://api.tixstock.com/v1/events/add/{event_id}

Authorisation

Authorisation	Description
Bearer Token	A valid bearer token must be provided within the header parameters for the API request. To generate an access token, please see your API settings from within the Tixstock Reseller Admin Area.

Please see 'Authentication - Bearer Tokens' for further information

Request Data

Parameter

Description

name *

The name of the event.
Type: String

currency *

The currency that the event listings will be sold in. Please refer to supported currencies.
Format: ISO 4217
Type: String

commission_percentage_fee

The commission percentage fee charged to a broker for listing tickets for this event.
Type: Two point decimal number

datetime *

Type: Date in ISO-8601 UTC Format
Example: 2020-03-10T17:30:00-0400

venue *

id *	The resellers venue ID. Type: String
name *	The events venue name. Type: String
address_line_1 *	The events venue address line 1. Type: String
address_line_2	The events venue address line 2. Type: String
city	The events venue city. Type: String
state	The events venue state. Type: String
postcode *	The events venue postcode. Type: String
country_code *	ISO-3166-2 Format. Please refer to supported country codes Type: String

use_tixstock_venue_details *

Allows the reseller to use Tixstock Venue Details rather than their own.
If the reseller choices to use Tixstock venue details the venue_detail field must be empty or not provided.
Type: Int

0 = No
1 = Yes

Please note: Tixstock will display an error when the reseller uses Tixstock Venue Details and resellers event cannot be mapped to a Tixstock event.

venue_details

It is required that the reseller provide the venue’s categories and sections required for the seating information for the event, when not using Tixstock venue details.
If no venue details are provided and use_tixstock_venue_details is set to 0, the event will be added as 'General Admission.'
Type: Array

id *

The resellers ID for the seating category.
Type: Int

name *

The resellers name for the seating category.
Type: String

sections *

An array of all seating sections for the seating catgory Type: Array
id *	The resellers ID for the section. Type: String
name *	The resellers ID for the section. Type: String

performers *

An array of the event performers Type: Array
id *	The resellers performer ID. Type: String
name *	The performer name. Type: String

API Response:

Please note that depending on whether the event has been mapped to an existing Tixstock event, the data returned will either be Tixstock’s event data or the resellers event data.

{
  "data": {
    "id": "94159864",
    "name": "Norwich City FC vs Burnley FC Tickets",
    "currency": "EUR",
    "commission_percentage_fee": "10.00",
    "datetime": "2020-05-09T14:00:00+0000",
    "status": "Active",
    "map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
    "venue": {
      "id": "7845665",
      "name": "Carrow Road",
      "address_line_one": "",
      "address_line_two": "",
      "city": "Norwich",
      "state": "NFK",
      "postcode": "NR1 1JE",
      "country_code": "GB"
    },
    "use_tixstock_venue_details": "false",
    "venue_details": [
      {
        "id": "1234121",
        "name": "Away Fan Section",
        "sections": [
          {
            "id": "241231",
            "name": "Away Fan Section 21"
          },
          {
            "id": "241121",
            "name": "Away Fan Section 22"
          },
          {
            "id": "241011",
            "name": "Away Fan Section 23"
          }
        ]
      }
    ],
    "performers": [
      {
        "id": "5642621",
        "name": "Norwich City FC"
      },
      {
        "id": "5642912",
        "name": "Burnley FC"
      }
    ],
    "category": {
      "name": "Football",
      "upcoming_events": 908,
      "parent": {
        "name": "Sport",
        "parent": []
      }
    }
  },
  "meta": {
    "mode": "Production",
    "type": "event.create",
    "request_id": "b56a18e0eacdf51aa2a5306b0f533204"
  },
  "message": "Event successfully added."
}