Events

Create a new event

Creating new events is only allowed for registered organizations by authorizing themselves with an API token. These organizations must own reserved tags.

One or more reserved tags have to be provided upon creation. Otherwise all of the organization's reserved tags are added implicitly to the event.

post/events

Request body

idstring

Identifier of a resource

titlestring

descriptionstring

startinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

endinteger

Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)

created_atinteger

Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps

created_bystring

The email address of the user who is responsible for the content. This information is only available for authorized organizations.

latnumber double

Geographic latitude (in degrees)

lngnumber double

Geographic longitude (in degrees)

streetstring

zipstring

citystring

countrystring

statestring

emailstring

An e-mail address.

telephonestring

tagsTag[]

homepagestring

registration'email' | 'telephone' | 'homepage'

Type of registration

organizerstring

image_urlstring

image_link_urlstring

Example request

{
  "id": "7cee99c287094a94acbdcf29ffff2e85",
  "title": "A great event",
  "description": "Detailed description of the event",
  "start": 1547403509,
  "end": 1547403509,
  "created_at": 1547403509000,
  "lat": 37.2,
  "lng": 120.7,
  "email": "john.smith@example.com",
  "telephone": "001 123456789",
  "tags": [
    "organic",
    "non-profit"
  ],
  "homepage": "https://www.slowtec.de/",
  "registration": "telephone",
  "image_url": "https://www.slowtec.de/",
  "image_link_url": "https://www.slowtec.de/"
}

Response

Created a new event

string required

The ID of the created event

Changes

Changed in 3 of the 50 revisions of this API.1355

Aug 13, 2020b2a47c048e8361See the full diff
- ▲
  added UnixTime to the end request property allOf list
  request-property-all-of-added
- ▲
  added UnixTime to the start request property allOf list
  request-property-all-of-added
- ▲
  added UnixTimeMillis to the created_at request property allOf list
  request-property-all-of-added
- ▲
  removed UnixTime from the end request property oneOf list
  request-property-one-of-removed
- ▲
  removed UnixTime from the start request property oneOf list
  request-property-one-of-removed
- ▲
  the created_at request property type/format changed from integer/int64 to /
  request-property-type-changed
- ○
  the request optional property created_at became not read-only
  request-optional-property-became-not-read-only
Aug 13, 2020bca9ebb2d24a41See the full diff
- ▲
  added Email to the email request property allOf list
  request-property-all-of-added
- ▲
  added Phone to the telephone request property allOf list
  request-property-all-of-added
- ▲
  the email request property type/format changed from string/ to /
  request-property-type-changed
- ▲
  the telephone request property type/format changed from string/ to /
  request-property-type-changed
- ○
  the email request property's minLength was decreased from 3 to 0
  request-property-min-length-decreased
Aug 13, 2020ddfd4e39c98d353See the full diff
- ▲
  the email request property's minLength was increased from 0 to 3
  request-property-min-length-increased
- ▲
  the email request property type/format changed from / to string/
  request-property-type-changed
- ▲
  the telephone request property type/format changed from / to string/
  request-property-type-changed
- ●
  removed Email from the email request property allOf list
  request-property-all-of-removed
- ●
  removed Phone from the telephone request property allOf list
  request-property-all-of-removed
- ●
  removed UnixTime from the end request property allOf list
  request-property-all-of-removed
- ●
  removed UnixTime from the start request property allOf list
  request-property-all-of-removed
- ●
  removed UnixTimeMillis from the created_at request property allOf list
  request-property-all-of-removed
- ○
  the request optional property created_at became read-only
  request-optional-property-became-read-only
- ○
  added UnixTime to the end request property oneOf list
  request-property-one-of-added
- ○
  added UnixTime to the start request property oneOf list
  request-property-one-of-added
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history