App subscription

The monday.com framework relies on subscriptions that serve as a billing contract between a user and an app. You can learn more about app subscriptions and monetization here.

App subscription queries

This query returns the subscription details for the current app and account based on the token used. This method does not accept any arguments and returns an array. If an account has a mock subscription and a real one, it will only return the mock subscription.

Please note: You can only make this call within the context of an application, not from our API Playground.

query {
  app_subscription {
    billing_period
    days_left
    is_trial
    plan_id
    renewal_date
  }
}
let query = "query { app_subscription { billing_period days_left is_trial plan_id renewal_date } }";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

The example response body from the above query.

{ 
    "data": {
        "app_subscription":[
            {
                "billing_period": "monthly",
                "days_left": 278,
                "is_trial": true,
                "plan_id": "basic_plan_15_users",
                "renewal_date": "2023-08-27T00:00:00+00:00",
            }
        ]
    },
    "account_id": 5
}

Fields

Fields are used to return specific properties in an object. The following fields will determine what information is returned from your app subscription query.

FieldsDescription
billing_period StringThe billing period frequency, is either monthly or yearly.
days_left IntThe number of days left until the subscription ends.
is_trial BooleanShows true if it is still a trial subscription.
plan_id String!The subscription plan ID on the app's side.
renewal_date Date!The date when the subscription renews.

📘

Have questions?

Join our developer community! You can share your questions and learn from fellow users and monday.com product experts.

Don't forget to search before opening a new topic!