Installing your app

Before using any of your app features, an account admin need to first install the app to their account. This applies to both marketplace apps and private apps for a specific account.

Install and Uninstall URLs

You can add install and uninstall URLs so that your application is notified when an admin installs an app. This is useful for tracking how many installs your app has, or for managing subscriptions and external webhooks.

When your app is installed, your install URL will receive a POST request from the monday apps server with a JSON object about the installation event. You can use this to kick off some application logic, such as counting how many installs your app has, starting a trial period for the customer, and more.

When the app is uninstalled, your uninstall URL will receive a similar POST request.

Samples of the install and uninstall event payloads are below. Timestamps are in UTC:

{
  "app_id": 3184,
  "account_id": 123456,
  "user_id": 234567,
  "timestamp": "2021-10-28T14:55:34+00:00",
  "version_data": {
    "major": 1,
    "minor": 1,
    "patch": 0,
    "type": "minor"
  },
  "type": "install"
}
{
  "app_id": 3184,
  "account_id": 1825528,
  "user_id": 4012689,
  "timestamp": "2021-10-28T14:56:17+00:00",
  "version_data": {
    "major": 1,
    "minor": 1,
    "patch": 0,
    "type": "minor"
  },
  "type": "uninstall"
}

For an explanation of the different IDs in the payload, check out this table: Multitenancy Best Practices

You can add the install and uninstall URLs by scrolling to the bottom of your app's Basic Information section:

How do I install an app on my own account?

You can install your app on your own account directly from the Developers' section of your account. This is useful if you're building an app and want others on your account to use its features on their boards.

In the leftpane of the main app page, you will see an "Install" tab. Click this to see an option to install your app:

How do my users install my app on their account?

Others can install your app directly on their account if you publish it and share the installation link with them. For a full walkthrough on how to do this, check out this article: Sharing Your Apps with Customers

If your app is listed in the monday apps marketplace, any monday.com user can install your app. For a full walkthrough of the marketplace install process, check out this article: monday apps marketplace


Did this page help you?