The monday.com favorites API lets you query a user's favorites.

Each of the object types described below represents a specific aspect of a favorite. They can be queried as subfields on the favorites query or provide favorite metadata in mutations.

🚧 The following types are only available in API versions 2025-10 and later

CreateFavoriteInput

An object containing the input of the new favorite to create.

Field	Description	Input Fields
name `String`	The name of the object to mark as a favorite.
newPosition `ObjectDynamicPositionInput`	The new position of the favorite object.	nextObject `HierarchyObjectIDInputType` prevObject `HierarchyObjectIDInputType`
object `HierarchyObjectIDInputType!`	The type of object to mark as a favorite.	id `ID!` type `ObjectType!`

CreateFavoriteResultType

An object containing the result of creating a new favorite via the API.

Field	Description	Supported Subfields
favorites `HierarchyObjectItem`	The new favorite object's metadata.	accountId `Int` createdAt `Date` folderId `ID` hierarchyListData `ListID` id `ID` object `HierarchyObjectID` position `Float` updatedAt `Date`

DeleteFavoriteInput

An object containing the input of the favorite to delete.

Field	Description	Input Fields
object `HierarchyObjectIDInputType!`	The object to remove from the favorites.	id `ID!` type `ObjectType!`

DeleteFavoriteInputResultType

An object containing the result of deleting a favorite object via the API.

Field	Description
success `Boolean`	Whether the favorite was successfully deleted.

HierarchyObjectId

An object containing metadata about the favorited object.

Field	Description	Enum values
id `ID`	The object's unique identifier.
type `ObjectType`	The object's type.	`Board` `Folder` `Overview`

HierarchyObjectIDInputType

Metadata about the favorite object.

Field	Description	Enum Values
id `ID!`	The object's unique identifier.
type `ObjectType!`	The object's type.	`Board` `Folder` `Overview` (dashboard)

ListID

An object containing metadata about the favorited list.

Field	Description	Enum values
id `ID`	The list's unique identifier.
type `ListType`	The list's type.	`CustomizedList` `PersonalList` `Workspace`

UpdateObjectHierarchyPositionInput

An object containing the input of the favorite to update.

Field	Description	Input Fields
newFolder `ID`	The unique identifier of the folder to move the favorite object into.
newPosition `ObjectDynamicPositionInput`	The new position of the favorite object in the favorites list.	nextObject `HierarchyObjectIDInputType` prevObject `HierarchyObjectIDInputType`
object `HierarchyObjectIDInputType!`	The favorite object to update.

UpdateFavoriteResultType

An object containing the result of updating a favorite object's position via the API.

Field	Description	Supported Subfields
favorites `HierarchyObjectItem`	The updated favorite object's metadata.	accountId `Int` createdAt `Date` folderId `ID` hierarchyListData `ListID` id `ID` object `HierarchyObjectID` position `Float` updatedAt `Date`