---
title: "Create a new event"
method: POST
path: "/events"
tags: ["Events"]
---

# Create a new event

`POST /events`

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.

## Request body

- Event
  - `id` string — Identifier of a resource
  - `title` string
  - `description` string
  - `start` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
  - `end` integer — Unix time (number of seconds since 00:00::00 1. January, 1970, UTC)
  - `created_at` integer — Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps
  - `created_by` string — The email address of the user who is responsible for the content. This information is only available for authorized organizations.
  - `lat` number, double — Geographic latitude (in degrees)
  - `lng` number, double — Geographic longitude (in degrees)
  - `street` string
  - `zip` string
  - `city` string
  - `country` string
  - `state` string
  - `email` string — An e-mail address.
  - `telephone` string
  - `tags` Tag[]
  - `homepage` string
  - `registration` 'email' | 'telephone' | 'homepage' — Type of registration
  - `organizer` string
  - `image_url` string
  - `image_link_url` string

## Response `201`

Created a new event

- string — The ID of the created event

## Other responses

- `401` — Access token is missing or invalid or the user has insufficient permission

## Changes

- **2020-08-13** `b2a47c048e83` — 6 breaking, 1 info
  - added `#/components/schemas/UnixTime` to the `end` request property `allOf` list
  - added `#/components/schemas/UnixTime` to the `start` request property `allOf` list
  - added `#/components/schemas/UnixTimeMillis` to the `created_at` request property `allOf` list
  - removed `#/components/schemas/UnixTime` from the `end` request property `oneOf` list
  - …3 more
- **2020-08-13** `bca9ebb2d24a` — 4 breaking, 1 info
  - added `#/components/schemas/Email` to the `email` request property `allOf` list
  - added `#/components/schemas/Phone` to the `telephone` request property `allOf` list
  - the `email` request property type/format changed from `string`/`` to ``/``
  - the `telephone` request property type/format changed from `string`/`` to ``/``
  - …1 more
- **2020-08-13** `ddfd4e39c98d` — 3 breaking, 5 warning, 3 info
  - the `email` request property's minLength was increased from `0` to `3`
  - the `email` request property type/format changed from ``/`` to `string`/``
  - the `telephone` request property type/format changed from ``/`` to `string`/``
  - removed `#/components/schemas/Email` from the `email` request property `allOf` list
  - …7 more

[Change history](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/changes/events/post.md)

---

[API](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api.md) · [All operations](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kartevonmorgen/openfairdb-api/revisions/4c454390b099/schema)