# Create a broadcast message

**POST /broadcast_messages**

This feature was introduced in GitLab 8.12.


## Servers
- https://www.gitlab.com/api/v4: https://www.gitlab.com/api/v4 ()


## Authentication methods
- Api key auth


## Parameters



### Body: application/json (object)

- **message** (string)
  Message to display
- **starts_at** (string(date-time))
  Starting time
- **ends_at** (string(date-time))
  Ending time
- **color** (string)
  Background color
- **font** (string)
  Foreground color
- **target_access_levels** (array[integer(int32)])
  Target user roles
- **target_path** (string)
  Target path
- **broadcast_type** (string)
  Broadcast type. Defaults to banner
- **dismissable** (boolean)
  Is dismissable


## Responses
### 201
Create a broadcast message

#### Body: application/json (object)
- **id** (string)

- **message** (string)

- **starts_at** (string)

- **ends_at** (string)

- **color** (string)

- **font** (string)

- **target_access_levels** (string)

- **target_path** (string)

- **broadcast_type** (string)

- **dismissable** (string)

- **active** (string)



[Powered by Bump.sh](https://bump.sh)