---
title: "Create New Emoji"
method: PUT
path: "/custom/emoji/{emoji_id}"
tags: ["Emojis"]
---

# Create New Emoji

`PUT /custom/emoji/{emoji_id}`

Create an emoji by its Autumn upload id.

## Path parameters

- `emoji_id` string, required

## Headers

- `X-Audit-Log-Reason` string

## Request body

- DataCreateEmoji — Create a new emoji
  - `name` string, required — Server name
  - `parent` union, required — Parent Id of the emoji
    - object
      - `type` 'Server', required
      - `id` string, required
    - object
      - `type` 'Detached', required
  - `nsfw` boolean — Whether the emoji is mature

## Response `200`

- Emoji — Emoji
  - `_id` string, required — Unique Id
  - `parent` union, required — Parent Id of the emoji
    - object
      - `type` 'Server', required
      - `id` string, required
    - object
      - `type` 'Detached', required
  - `creator_id` string, required — Uploader user id
  - `name` string, required — Emoji name
  - `animated` boolean — Whether the emoji is animated
  - `nsfw` boolean — Whether the emoji is marked as nsfw

## Other responses

- `default` — An error occurred.

## Changes

- **2026-08-27** `a09d9d97fec9` — 1 info
  - added the required property `oneOf[subschema #2]/locale` to the response with the `default` status
- **2026-08-25** `66efa81c8e1f` — 1 breaking
  - added `subschema #2` to the response body `oneOf` list for the response status `default`
- **2026-07-26** `7a23c8b93766` — 1 breaking, 1 info
  - added `subschema #65, subschema #66, subschema #67, subschema #81, subschema #82, subschema #83, subschema #84, subschema #85, subschema #86, subschema #87, subschema #88, subschema #89, subschema #90, subschema #91, subschema #92, subschema #93, subschema #94, subschema #95` to the response body `oneOf` list for the response status `default`
  - added the new optional `header` request parameter `X-Audit-Log-Reason`

[Change history](https://skmtc.dev/revolt/apis/revolt-api/changes/custom/emoji/:emoji_id/put.md)

---

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