---
title: "Create a new banner"
method: POST
path: "/banner"
tags: ["banner"]
---

# Create a new banner

`POST /banner`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/banner`
- Auth: none declared

Creeate a new inactive banner

## Request body

- BannerCreate
  - `content` string

## Response `201`

banner was created successfully.

- Banner
  - `id` string
  - `content` string

## Changes

- **2021-01-28** `d00878b65739`: 1 breaking, 1 warning
  - the `id` response's property format changed from `long` to no format for status `201`
  - removed the optional property `title` from the response with the `201` status
- **2021-01-26** `0ba0e4f05050`: 1 warning
  - removed the optional property `active` from the response with the `201` status
- **2021-01-26** `b3aae77bebcc`: 1 warning
  - removed the request property `title`

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-banner-service/changes/banner/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-banner-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-banner-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-banner-service/revisions/d00878b65739?raw)