The monday.com app APIs enable you to create and update apps.

The types below are used by app queries and mutations, and are not independently queryable.

CreateAppInput

An object containing the new app's configuration data.

Field	Type	Description	Enum Values
collaborators	`[ID!]`	An array of the new app's collaborators.
description	`String`	The new app's description.
kind	`AppKind`	The new app's visibility type.	`PRIVATE` `PUBLIC`
name	`String!`	The new app's name.
permissions	`[AppPermission!]`	An array of the new app's permission scopes.	`ACCOUNT_READ` `ASSETS_READ` `BOARDS_READ` `BOARDS_WRITE` `DEPARTMENTS_READ` `DEPARTMENTS_WRITE` `DOCS_READ` `DOCS_WRITE` `ME_READ` `NOTIFICATIONS_WRITE` `TAGS_READ` `TEAMS_READ` `TEAMS_WRITE` `UPDATES_READ` `UPDATES_WRITE` `USERS_READ` `USERS_WRITE` `WEBHOOKS_READ` `WORKSPACES_READ` `WORKSPACES_WRITE`
slug	`String`	A URL-friendly identifier in `{account_slug}_{app_slug}` format. Must contain at least three letters, numbers, dashes, and underscores.
webhook_url	`String`	The new app's webhook endpoint URL.

UpdateAppInput

An object containing the app's updated configuration data.

Field	Type	Description	Enum Values
collaborators	`[ID!]`	An array of the new app's collaborators.
description	`String`	The new app's description.
kind	`AppKind`	The new app's visibility type.	`PRIVATE` `PUBLIC`
name	`String!`	The new app's name.
permissions	`[String!]`	An array of the new app's permission scopes.
slug	`String`	The new app's slug.
webhook_url	`String`	The new app's webhook endpoint URL.

🚧
Only available in API versions 2026-10 and later

Represents a version of a developer app. Returned by the promote_app mutation and queryable via the versions field on App.

Field	Type	Description
id `ID`	`ID`	The app version's unique identifier.
status `AppVersionStatus`	`AppVersionStatus`	The current status of this app version.

🚧
Only available in API versions 2026-10 and later

Enum representing the lifecycle status of a developer app version.

Enum Value	Description
`DRAFT`	The version is in draft and has not been promoted to live.
`LIVE`	The version is live and available to users.
`DEPRECATED`	The version has been deprecated and is no longer the active live version.
`PROMOTING`	The version is currently being promoted to live. Poll `status` until it changes to `LIVE` or `DEPRECATED`.