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 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 (potentially something to do with pagination) false

Get Custom Emoji Pack🔗

POSThttps://media.guilded.gg/media/fetch_emote_pack

Get the contents of an emoji pack.

JSON Params🔗
Field Type Description
url string the emoji pack to get (must link to a valid emoji pack JSON file)

Upload Custom Emoji Pack🔗

POSThttps://media.guilded.gg/media/import_emote_pack

Info

After doing this, call Bulk Create Custom Emoji to actually import the emojis.

Upload the contents of an emoji pack to Guilded. Returns an array of {url: url, name: name} on success, where url is the URL to the uploaded image on Guilded's CDN, and name is the name of the emoji from the emoji pack.

JSON Params🔗
Field Type Description
url string the emoji pack to import (must link to a valid emoji pack JSON file)
uploadTrackingId? string unknown. looks like "r-0123456-7891234"

Create Team Emoji🔗

POST/teams/{team.id}/customReactions

Create a new emoji for the team. Returns the new emoji object on success.

Info

You can request this endpoint without any image URL and recieve an HTTP 200 response, but no emoji will actually show up or be usable in the team.

JSON Params🔗
Field Type Description
name string name of the emoji
png? string url to the image you uploaded (CustomReaction)
webp? string url to the image you uploaded (CustomReaction)
apng? string url to the image you uploaded (CustomReaction)

Bulk Create Custom Emoji🔗

POST/teams/{team.id}/bulkCustomReactions

Bulk-add custom emojis to the team. Returns an array of emoji on success.

Field Type Description
urls array of partial emojis the list of emojis to add. each item should include a name (alphanumberic only) and a url (CustomReaction). if you are importing an emoji pack, you may simply re-use that endpoint's response

Modify Team Emoji🔗

PATCH/teams/{team.id}/customReactions/{emoji.id}

Modify the given emoji.

JSON Params🔗
Field Type Description
name string name of the emoji

Delete Team Emoji🔗

DELETE/teams/{team.id}/customReactions/{emoji.id}

Delete the given emoji.

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"}
]