Skip to content

WebhookCustomEmoji

The emoji of a custom_emoji.* message: AdminCustomEmoji with the operation. A custom_emoji.deleted message presents the emoji as it was before the deletion.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
shortcode
required

The shortcode, without the colons around it.

string
local
required

Whether the emoji is of this instance.

boolean
domain

The domain of a remote emoji; absent for a local one.

string
uri

The ActivityPub id of the emoji: https://{host}/ap/emojis/{id} for a local one, and the recorded one for a remote one; absent when a remote emoji has none.

string format: uri
url

The URL of the image, animated when the emoji is; absent when the image cannot be shown (such as a remote one from a domain whose media the instance rejects).

string format: uri
static_url

The URL of a still image of the emoji; absent with url.

string format: uri
state
required

Whether the emoji is shown; a disabled one stays :shortcode: text.

string
Allowed values: enabled disabled
visible_in_picker
required

Whether the picker offers the local emoji; always true for a remote one.

boolean
category

The category of a local emoji in the picker; absent for none.

string
aliases
required

The other names of a local emoji that the picker finds it by.

Array<string>
created_by

The account of the user who made a local emoji: the requester of an approved request, or the administrator who registered or copied it. Absent for an emoji made with the CLI, a remote one, and one whose creator’s account is deleted (created_by_deleted).

Schema: Account

object
created_by_deleted
required

Whether a user made the emoji whose account no longer exists.

boolean
created_at
required

When the emoji was registered or first seen.

string format: date-time
updated_at
required

When its current image was set, its ActivityPub updated.

string format: date-time
operation
required

The operation, named as in the audit log: custom_emoji_created, custom_emoji_image_replaced, custom_emoji_copied, custom_emoji_updated, custom_emoji_enabled, custom_emoji_disabled, or custom_emoji_deleted.

string

Example generated

{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"shortcode": "example",
"local": true,
"domain": "example",
"uri": "https://example.com",
"url": "https://example.com",
"static_url": "https://example.com",
"state": "enabled",
"visible_in_picker": true,
"category": "example",
"aliases": [
"example"
],
"created_by": {},
"created_by_deleted": true,
"created_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z",
"operation": "example"
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site