NOnotion
Custom emojis

List custom emojis

get/v1/custom_emojis

Request

  • Base URL
    https://api.notion.com/admin
  • URL
    https://api.notion.com/admin/v1/custom_emojis
  • Auth
    HTTP bearer

Query parameters

start_cursorstring

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_sizeinteger

The number of items from the full list desired in the response. Maximum: 100

namestring

If supplied, filters custom emojis by exact name match. Useful for resolving a custom emoji name to its ID.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'list' required

Always list

type'custom_emoji' required

Always custom_emoji

has_moreboolean required

Whether there are more results available.

next_cursorstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.