List custom emojis
Retrieves a list of custom emojis in the workspace.
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.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Query Parameters
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.
Response
Always list
"list"Always custom_emoji
"custom_emoji"The list of custom emojis.
100Whether there are more results available.
The cursor to use for the next page of results, or null if there are no more results.