Developers: Get a first look at our new Developer Platform on May 13. Register today →
import { Client } from "@notionhq/client"
import { collectPaginatedAPI } from "@notionhq/client"
const notion = new Client()
// Single page
const response = await notion.customEmojis.list()
// All pages with pagination helper
const allEmojis = await collectPaginatedAPI(
notion.customEmojis.list,
{}
){
"object": "<string>",
"type": "<string>",
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"url": "<string>"
}
],
"has_more": true,
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Retrieves a list of custom emojis in the workspace.
import { Client } from "@notionhq/client"
import { collectPaginatedAPI } from "@notionhq/client"
const notion = new Client()
// Single page
const response = await notion.customEmojis.list()
// All pages with pagination helper
const allEmojis = await collectPaginatedAPI(
notion.customEmojis.list,
{}
){
"object": "<string>",
"type": "<string>",
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"url": "<string>"
}
],
"has_more": true,
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}See Pagination for details about how to use a cursor to iterate through the list. Use theDocumentation Index
Fetch the complete documentation index at: https://developers.notion.com/llms.txt
Use this file to discover all available pages before exploring further.
name query parameter to filter by exact name match, which is useful for resolving a custom emoji name to its ID.Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 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.
The number of items from the full list desired in the response. Maximum: 100
1 <= x <= 100If supplied, filters custom emojis by exact name match. Useful for resolving a custom emoji name to its ID.
Always list
"list"Always custom_emoji
"custom_emoji"The list of custom emojis.
100Show child attributes
Whether there are more results available.
The cursor to use for the next page of results, or null if there are no more results.