---
title: "Changes to Create badge"
method: POST
path: "/admin/badges.json"
---

# Changes to Create badge

`POST /admin/badges.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 52 revisions.

- **2024-12-29** `40b2f42a88e8`: 1 info
- **2024-09-20** `19cf9c57d50c`: 1 info
- **2022-03-05** `e1108b0434c0`: 3 breaking, 12 warning, 2 info

## Changes

- **2024-12-29** `40b2f42a88e8`: 1 info
  - added the required property `badge/show_in_post_header` to the response with the `200` status
- **2024-09-20** `19cf9c57d50c`: 1 info
  - added the required property `badge/image_upload_id` to the response with the `200` status
- **2022-03-05** `e1108b0434c0`: 3 breaking, 12 warning, 2 info
  - the request's body type changed from `object` to no type
  - the request property `badge_type_id` became required
  - the request property `name` became required
  - removed the request property `allow_title`
  - removed the request property `auto_revoke`
  - removed the request property `badge_grouping_id`
  - removed the request property `description`
  - removed the request property `enabled`
  - removed the request property `icon`
  - removed the request property `image`
  - removed the request property `listable`
  - removed the request property `long_description`
  - removed the request property `multiple_grant`
  - removed the request property `show_posts`
  - removed the request property `target_posts`
  - api operation id `createBadge` was added
  - added the media type `application/json` for the response with the status `200`

---

[Operation](https://skmtc.dev/discourse/apis/discourse-api-documentation/docs/admin/badges.json/post.md) - [API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [Page](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/admin/badges.json/post)