Learn how to create portfolio boards using the platform API
The monday.com portfolio solution provides a structure for managing projects at both a high-level and granular level. A solution is made up of two board types:
- Portfolio board: Connects multiple project boards to give a consolidated, interactive overview of all projects.
- Project board: Used for managing individual project details. Updates sync automatically to the portfolio board.
Note: Portfolio solutions are only available on Enterprise plans.
Mutations
Create a portfolio board
🚧 Only available in API versions 2025-10 and later
Required scope: boards:write
The create_portfolio
mutation enables you to create a new portfolio board via the API. It returns the CreatePortfolioResult
type which allows you to specify what fields to query when you run it.
This mutation is only available for Enterprise plans.
mutation {
create_portfolio (
boardName: "New Portfolio Board"
boardPrivacy: "private"
destinationWorkspaceId: 12345,
) {
success
message
solution_live_version_id
}
}
Arguments
You can use the following arguments to define the new portfolio board's characteristics.
Argument | Description | Accepted values |
---|---|---|
boardName String! | The new portfolio board's name. | |
boardPrivacy String! | The new portfolio board's privacy settings. | "private" "share" |
destinationWorkspaceId Int | The unique identifier of the workspace to create the portfolio board in. |