---
title: "Gallery"
method: POST
path: "/clubs/{club_id}/galleries"
tags: ["Gallery"]
---

# Gallery

`POST /clubs/{club_id}/galleries`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/clubs/{club_id}/galleries`
- Auth: API key in query parameter `auth_token`

Create a new gallery.

## Path parameters

- `club_id` integer, required

## Request body

- object
  - `gallery` object, required
    - `id` integer: ID of the gallery.
    - `title` string, required: Name of the gallery.
    - `subhead` string: Subhead of the gallery.
    - `description` string: Description of the gallery.
    - `category` string, required: Category of the gallery.
    - `keywords` string[]: List of keywords of the gallery.
    - `external_id` string, required: ID from an external system of the gallery.
    - `external_landing_page_url` string: URL to landing page for teh gallery.
    - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
    - `images` object[]: List of images in this gallery.
      - `id` integer: ID of the image.
      - `position` integer: Position of image in the gallery. Set to `null` to append.
      - `teaser` boolean: True sets this image as teaser for the gallery.
      - `title` string: Title of the image.
      - `description` string: Description of the image.
      - `copyright` string: Copyright notic of the image.
      - `keywords` string[]: List of keywords.
      - `external_id` string, required: ID of the image in an external system.
      - `external_image_url` string, required: URL where the image is downloaded from.
      - `external_landing_page_url` string: URL to a landing page.
      - `url` string: URL to the image.
      - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
      - `width` integer: Width of the image in pixels.
      - `height` integer: Height of the image in pixels.
      - `size` object: URL to teaser image in different resolution.
        - `preview` string
        - `overview` string

## Response `200`

OK

- object
  - `data` object
    - `id` integer: ID of the gallery.
    - `title` string, required: Name of the gallery.
    - `subhead` string: Subhead of the gallery.
    - `description` string: Description of the gallery.
    - `category` string, required: Category of the gallery.
    - `keywords` string[]: List of keywords of the gallery.
    - `external_id` string, required: ID from an external system of the gallery.
    - `external_landing_page_url` string: URL to landing page for teh gallery.
    - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
    - `images` object[]: List of images in this gallery.
      - `id` integer: ID of the image.
      - `position` integer: Position of image in the gallery. Set to `null` to append.
      - `teaser` boolean: True sets this image as teaser for the gallery.
      - `title` string: Title of the image.
      - `description` string: Description of the image.
      - `copyright` string: Copyright notic of the image.
      - `keywords` string[]: List of keywords.
      - `external_id` string, required: ID of the image in an external system.
      - `external_image_url` string, required: URL where the image is downloaded from.
      - `external_landing_page_url` string: URL to a landing page.
      - `url` string: URL to the image.
      - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
      - `width` integer: Width of the image in pixels.
      - `height` integer: Height of the image in pixels.
      - `size` object: URL to teaser image in different resolution.
        - `preview` string
        - `overview` string

## Other responses

- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)