New Event API

This API allows you to create a new event within an event concept.

Endpoint

POST https://business.festivalcadeau.com/api/endpoint/v1/newevent

Request Parameters

Parameter Type Requirement Description
apikey string Required Your unique API key
events array Required An array of event objects
Event object parameters:
eventprovider_id string Required ID of the event provider
event_name string Required Name of the event
event_organiser string Required Company name of the event organiser
event_start_date string Required Start date of the event in yyyy-mm-dd format (must be in the future)
event_start_time string Required Start time of the event in hh:ii:ss format
ticket_link string Required Link where customers can buy tickets
Parameter Type Requirement Description
building_name string Highly Recommended Name of the venue or building
Streetname string Highly Recommended Street of the event location
Streetnumber string Highly Recommended House number of the event location
zipcode string Highly Recommended Postal code of the event location
city string Highly Recommended City where the event is taking place
country string Highly Recommended Country where the event is taking place
poster_url string Highly Recommended URL to the poster for the event
banner_url string Highly Recommended URL to the banner for the event
event_introductiontext string Highly Recommended The event description
genre string Recommended Comma-separated list of music genres
event_end_date string Recommended End date of the event in yyyy-mm-dd format
event_end_time string Recommended End time of the event in hh:ii:ss format
activated int Optional 0 = Not published, 1 = published
event_key string Optional Unique key for your system
lineup string Optional Comma-separated list of artists in the lineup
minimumage string Optional Minimum age for the event
event_price string Optional Starting price in euro
event_videourl string Optional Link to a video promoting the event
event_link string Optional URL to the event website

Example request JSON

{
  "apikey": "your_unique_api_key",
  "events": [
    {
      "eventprovider_id": "event_provider_id_1",
      "event_name": "Event 1",
      "event_organiser": "Organiser 1",
      "event_key": "event_key_1",
      "event_start_date": "2023-07-20",
      "event_start_time": "18:00:00",
      "event_end_date": "2023-07-21",
      "event_end_time": "00:00:00",
      "genre": "Rock, Pop",
      "lineup": "Artist 1, Artist 2",
      "minimumage": "18",
      "building_name": "Venue 1",
      "streetname": "Street 1",
      "streetnumber": "14B",
      "zipcode": "1012 NX",
      "city": "Amsterdam",
      "country": "The Netherlands",
      "event_price": "50",
      "event_videourl": "http://videourl.com/1",
      "event_introductiontext": "This is a description for Event 1.",
      "poster_url": "http://posterurl.com/1",
      "banner_url": "http://bannerurl.com/1",
      "ticket_link": "http://ticketlink.com/1",
      "event_link": "http://eventwebsite.com/1"
    },
    {
      "eventprovider_id": "event_provider_id_1",
      "event_name": "Event 2",
      "event_organiser": "Organiser 1",
      "event_key": "event_key_2",
      "event_start_date": "2023-08-15",
      "event_start_time": "20:00:00",
      "event_end_date": "2023-08-16",
      "event_end_time": "01:00:00",
      "genre": "Jazz, Blues",
      "lineup": "Artist 3, Artist 4",
      "minimumage": "21",
      "building_name": "Venue 2",
      "streetname": "Street 1",
      "streetnumber": "14B",
      "zipcode": "75001",
      "city": "Paris",
      "country": "France",
      "event_price": "60",
      "event_videourl": "http://videourl.com/2",
      "event_introductiontext": "This is a description for Event 2.",
      "poster_url": "http://posterurl.com/2",
      "banner_url": "http://bannerurl.com/2",
      "ticket_link": "http://ticketlink.com/2",
      "event_link": "http://eventwebsite.com/2"
    }
  ]
}

Successful Response

[
    {
        "message": "Event created successfully",
        "id": 3408,
        "title": Liquicity 2023
    }
]

Error Response

{"error": "API key not valid"}