Stickers

Stickers are embedded images that can be sent along with messages. They can be either standard stickers, which are official, first-party stickers, or guild stickers, which are custom stickers uploaded by users in a guild.

Sticker Pack Object

A pack of standard stickers.

Sticker Pack Structure

Example Sticker Pack

{
  "id": "847199849233514549",
  "stickers": [],
  "name": "Wumpus Beyond",
  "sku_id": "847199849233514547",
  "cover_sticker_id": "749053689419006003",
  "description": "Say hello to Wumpus!",
  "banner_asset_id": "761773777976819732"
}

Sticker Object

A sticker that can be sent in messages.

Sticker Structure

¹ Only included for guild stickers when fetched through the Get Guild Stickers or Get Guild Sticker endpoints by a user with the MANAGE_EXPRESSIONS permission.

² A comma separated list of keywords is the format used in this field by standard stickers, but this is just a convention. Incidentally, official clients will always use a name generated from an emoji as the value of this field when creating or modifying a guild sticker.

Sticker Types

Sticker Format Types

Example Sticker

{
  "id": "749054660769218631",
  "name": "Wave",
  "tags": "wumpus, hello, sup, hi, oi, heyo, heya, yo, greetings, greet, welcome, wave, :wave, :hello, :hi, :hey, hey, \ud83d\udc4b, \ud83d\udc4b\ud83c\udffb, \ud83d\udc4b\ud83c\udffc, \ud83d\udc4b\ud83c\udffd, \ud83d\udc4b\ud83c\udffe, \ud83d\udc4b\ud83c\udfff, goodbye, bye, see ya, later, laterz, cya",
  "type": 1,
  "format_type": 3,
  "description": "Wumpus waves hello",
  "asset": "",
  "pack_id": "847199849233514549",
  "sort_value": 12
}

Sticker Item Object

The smallest amount of data required to render a sticker. A partial sticker object.

Sticker Item Structure

Endpoints

Get Sticker Packs

Returns the list of sticker packs available to use.

Response Body

Get Sticker Pack

Returns a sticker pack object for the given pack ID.

Get Sticker

Returns a sticker object for the given sticker ID.

Get Sticker Guild

Returns a discoverable guild object for the guild that owns the given sticker. This endpoint requires the guild to be discoverable, not be auto-removed, and have guild expression discoverability enabled.

Get Guild Stickers

Returns an array of sticker objects for the given guild. Includes the user field if the user has the CREATE_EXPRESSIONS or MANAGE_EXPRESSIONS permission.

Get Guild Sticker

Returns a sticker object for the given guild and sticker IDs. Includes the user field if the user has the CREATE_EXPRESSIONS or MANAGE_EXPRESSIONS permission.

Create Guild Sticker

Creates a new sticker for the guild. Must be a multipart/form-data body. Requires the CREATE_EXPRESSIONS permission. Returns the new sticker object on success. Fires a Guild Stickers Update Gateway event.

Every guilds has five free sticker slots by default, and each premium tier (boost level) will grant access to more slots.

Form Params

Modify Guild Sticker

Modifies the given sticker. For stickers created by the current user, requires either the CREATE_EXPRESSIONS or MANAGE_EXPRESSIONS permission. For other stickers, requires the MANAGE_EXPRESSIONS permission. Returns the updated sticker object on success. Fires a Guild Stickers Update Gateway event.

JSON Params

Delete Guild Sticker

Deletes the given sticker. For stickers created by the current user, requires either the CREATE_EXPRESSIONS or MANAGE_EXPRESSIONS permission. For other stickers, requires the MANAGE_EXPRESSIONS permission. Returns a 204 empty response on success. Fires a Guild Stickers Update Gateway event.