Skip to content

Custom Reactions/Emojis🔗

A "custom reaction" refers to a custom server emoji in Guilded. However, since this name is silly and confusing, this page will refer to this concept as "emojis", "custom emoijs", or "team emojis".

Custom Emoji Object🔗

Custom Emoji Structure🔗
Field Type Description
id integer emoji's id (cannot be used for forming a cdn url)
name string emoji's name
createdBy user id user's id that created this emoji
createdAt ISO8601 timestamp when this emoji was created
png string aws url to this emoji's image file
webp string aws url to this emoji's image file
apng string aws url to this emoji's image file
aliases array of strings an array of aliases this emoji can be used with
teamId team id team's id that this emoji is from
isDeleted boolean whether this emoji has been deleted
discordEmojiId ?snowflake the discord emoji's id this emoji corresponds to
discordSyncedAt ?ISO8601 timestamp when this emoji was last synced with its discord counterpart
Emoji Example🔗
{
  "id": 239839,
  "name": "beepboop",
  "png": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/36b263b547cf38de0d55ef01e1ab55ab-Full.webp?w=120&h=120",
  "webp": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/36b263b547cf38de0d55ef01e1ab55ab-Full.webp?w=120&h=120",
  "apng": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/36b263b547cf38de0d55ef01e1ab55ab-Full.webp?w=120&h=120",
  "aliases": [],
  "createdAt": "2020-07-28T06:48:56.525Z",
  "createdBy": "EdVMVKR4",
  "teamId": "NRgqXnPE",
  "isDeleted": false,
  "discordEmojiId": null,
  "discordSyncedAt": "2020-07-28T06:49:03.668Z"
}

Emoji Pack Object🔗

Info

Emoji packs can include a maximum of 50 emojis.

Emoji Pack Structure🔗
Field Type Description
name string name of the emoji pack
author string author of the emoji pack
emojis array of partial emojis list of emojis to import. each item should include a name (alphanumberic only) and a url
Example Emoji Pack🔗
{
  "name": "Guilded emojis",
  "author": "emoji.gg",
  "emotes": [
    {
      "name": "gil_wut",
      "url": "https://emoji.gg/assets/emoji/6017_gil_wut.png"
    },
    {
      "name": "gil_woah",
      "url": "https://emoji.gg/assets/emoji/9837_gil_woah.png"
    },
    {
      "name": "gil_thumb",
      "url": "https://emoji.gg/assets/emoji/8264_gil_thumb.png"
    },
    {
      "name": "gil_think",
      "url": "https://emoji.gg/assets/emoji/2294_gil_think.png"
    },
    {
      "name": "gil_sweat",
      "url": "https://emoji.gg/assets/emoji/5722_gil_sweat.png"
    },
    {
      "name": "gil_smug",
      "url": "https://emoji.gg/assets/emoji/7756_gil_smug.png"
    },
    {
      "name": "gil_shrug",
      "url": "https://emoji.gg/assets/emoji/3769_gil_shrug.png"
    },
    {
      "name": "gil_scared",
      "url": "https://emoji.gg/assets/emoji/2002_gil_scared.png"
    },
    {
      "name": "gil_salute",
      "url": "https://emoji.gg/assets/emoji/7259_gil_salute.png"
    },
    {
      "name": "gil_ree",
      "url": "https://emoji.gg/assets/emoji/6400_gil_ree.png"
    },
    {
      "name": "gil_stare",
      "url": "https://emoji.gg/assets/emoji/9969_gil_stare.png"
    },
    {
      "name": "gil_notlikethis",
      "url": "https://emoji.gg/assets/emoji/1616_gil_notlikethis.png"
    },
    {
      "name": "gil_lul",
      "url": "https://emoji.gg/assets/emoji/5606_gil_lul.png"
    },
    {
      "name": "gil_lol",
      "url": "https://emoji.gg/assets/emoji/7890_gil_lol.png"
    },
    {
      "name": "gil_wave",
      "url": "https://emoji.gg/assets/emoji/2469_gil_wave.png"
    },
    {
      "name": "gil_heh",
      "url": "https://emoji.gg/assets/emoji/6192_gil_heh.png"
    },
    {
      "name": "guilded",
      "url": "https://emoji.gg/assets/emoji/7391_guilded.png"
    },
    {
      "name": "gil_facepalm",
      "url": "https://emoji.gg/assets/emoji/7256_gil_facepalm.png"
    },
    {
      "name": "gil_eyes",
      "url": "https://emoji.gg/assets/emoji/6197_gil_eyes.png"
    },
    {
      "name": "gil_doge",
      "url": "https://emoji.gg/assets/emoji/1037_gil_doge.png"
    },
    {
      "name": "gil_deal_with_it",
      "url": "https://emoji.gg/assets/emoji/2315_gil_deal_with_it.png"
    },
    {
      "name": "gil_dab",
      "url": "https://emoji.gg/assets/emoji/5387_gil_dab.png"
    },
    {
      "name": "gil_cry",
      "url": "https://emoji.gg/assets/emoji/4846_gil_cry.png"
    },
    {
      "name": "cheer_gil",
      "url": "https://emoji.gg/assets/emoji/8188_cheer_gil.png"
    }
  ]
}

Get Team Emojis🔗

GET/teams/{team.id}/customReactions

Returns a list of emoji objects for the given team.

Query Params🔗
Field Type Description Required Default
maxItems integer the maximum number of emojis to return
when[upperValue] ISO8601 timestamp return emojis created after this time false
when[lowerValue] ISO8601 timestamp return emojis created before this time false
createdBy user id return emojis created by this user's id false
searchTerm string search emoji names with a string false
beforeId emoji id return emojis created before this emoji was created (for pagination) false

Emoji Packs🔗

This section has been moved to Media Endpoints.

Get Team Emoji Creators🔗

GET/teams/{team.id}/customReactionCreators

Get a list of users who have created emojis in this team.

Info

This will return each user once. To see how many emojis a specific user has uploaded, consider filtering the response from Get Team Emojis

Example Response🔗
[
  {"userId": "EdVMVKR4"},
  {"userId": "lAeMagzA"}
]