Using the apps framework, you can build apps on top of the monday.com platform. These apps extend the platform's core functionality by bridging gaps and enabling you to customize your workflows.

Apps can be shared directly with select accounts, listed in the app marketplace for all monday.com users, or kept private within the account. They are created and managed in the Developer Center.

Queries

Get app

Returns an object containing metadata about an app
Can be queried directly at the root or nested within a daily_analytics query

query {
  platform_api {
    daily_analytics {
      by_app {
        app {
          name
          features {
            type
            name
          }
          id
          api_app_id
          state
        }
        usage
      }
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($appId: ID!) { app (id: $appId) { features { id type } } }`;
const variables = {
  appId: 1234567890,
};
const response = await mondayApiClient.request(query, variables);

Arguments

Argument	Type	Description
id	`ID!`	The app's unique identifier.

Fields

Field	Type	Description	Enum Values
account_id	`ID`	The app's account ID.
api_app_id	`ID`	The app's unique API consumer identifier.
client_id	`String`	The app's unique API consumer identifier.
collaborators	`[User!]`	The app's collaborators.
created_at	`Date`	The app's creation date.
created_by	`ID`	The unique identifier of the user who created the app.
description	`String`	The app's description.
features	`[AppFeatureType!]`	The app's features.
id	`ID!`	The app's unique identifier.
kind	`String`	The app's kind.
name	`String`	The app's name.
permissions	`[String!]`	The app's permissions.
photo_url	`String`	The URL of the app's photo.
photo_url_small	`String`	The URL of the app's photo in a small size.
slug	`String`	The app's slug.
state	`String`	The app's state (active/inactive).
status	`AppStatus`	The app's status.	`DRAFT` `LIVE`
updated_at	`Date`	The date the app was last updated.
user_id	`ID`	The unique identifier of the user who created the app.
version_type	`String`	The app's latest version type.
webhook_url	`String`	The app's webhook endpoint URL.

Mutations

Create app

Creates a new app. Returns App.

mutation {
  create_app(
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name.",
      kind: PUBLIC,
      permissions: ["docs:write", "me:read"]
    }
  ) {
    description
    name
    kind
    permissions
    collaborators {
      id
    }
  }
}

Arguments

Argument	Type	Description
input	`CreateAppInput!`	An object containing the new app's configuration data.

Update app

Updates an app. Returns App.

🚧 Only works for app collaborators

mutation {
  update_app(
    id: 123456,
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name."
    }
  ) {
    description
    name
    collaborators {
      id
    }
  }
}

Arguments

Argument	Type	Description
id	`ID!`	The unique identifier of the app to update.
input	`UpdateAppInput!`	An object containing the updated app's configuration data.