Marketplace developers can grant app subscription discounts to attract and retain users. These can be managed, created, and deleted through both the Developer Center and the platform API.

Queries

You can use the marketplace_app_discounts query to retrieve an app's marketplace discount data via the API.

Only works for app collaborators
Returns an array containing metadata about a specific app discount
Can only be queried directly at the root; can't be nested within another query

query {
  marketplace_app_discounts(app_id: 123456) {
    account_slug
    discount
    valid_until  	
  }
}

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

const query = "query ($appId: ID!) { marketplace_app_discounts (app_id: $appId) { account_slug discount valid_until  	} }"
const variables = {
  appId: 123456
};

Arguments

You can use the following argument to reduce the number of results returned in your marketplace_app_discounts query.

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

Fields

You can use the following fields to specify what information your marketplace_app_discounts query will return.

Field	Description	Enum Values
account_id `ID!`	The account's unique identifier.
account_slug `String!`	The account's slug.
app_plan_ids `[String!]!`	The app plan IDs.
created_at `String!`	The discount's creation date.
discount `Int!`	The discount's percentage.
is_recurring `Boolean!`	Whether the discount is recurring.
period `DiscountPeriod`	The discount's period. If it returns `null`, the discount applies to both yearly and monthly plans.	`MONTHLY` `YEARLY`
valid_until `String!`	The date the discount is valid until.

Mutations

The API allows you to grant and delete discounts using the following mutations.

Grant marketplace app discount

The grant_marketplace_app_discount mutation grants a discount for a new marketplace app subscription via the API. You can specify which fields to return in the mutation response.

mutation {
  grant_marketplace_app_discount(
      account_slug: "Test",  
      app_id: 123456,
    	data: {
    		app_plan_ids: ["Basic"],
      	days_valid: 30, 
      	discount: 10, 
      	is_recurring: false, 
      	period: MONTHLY
    }) {
    granted_discount {
        app_id
      	period
      	discount
    }
  }
}

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

const query = "mutation ($slug: String!, $appId: ID!, $appPlanIds: [String!]!, $days: Int!, $discountPercent: Int!, $recurring: Boolean!, $period: DiscountPeriod) { grant_marketplace_app_discount ( account_slug: $slug, app_id: $appId, data: {app_plan_ids: $appPlanIds, days_valid: $days, discount: $discountPercent, is_recurring: $recurring, period: $period }) { granted_discount { app_id period discount } } }"
const variables = {
  appId: 123456,
  slug: "my-team-monday",
  appPlanIds: ["Basic"], 
  days: 30, 
  discountPercent: 10, 
  recurring: false, 
  period: "MONTHLY" 
};
const response = await mondayApiClient.request(query, variables);

Arguments

You can use the following arguments to specify which discount to grant.

Argument	Description	Supported Fields
account_slug `String!`	The account's slug.
app_id `ID!`	The app's unique identifier.
data `GrantMarketplaceAppDiscountData!`	The discount's details.	app_plan_ids `[String!]!` days_valid `Int!` discount `Int!` is_recurring `Boolean!` period `DiscountPeriod`

Delete marketplace app discount

The delete_marketplace_app_discount mutation deletes an existing discount for a marketplace app subscription via the API. You can specify which fields to return in the mutation response.

mutation {
  delete_marketplace_app_discount(
    account_slug: "Test", 
    app_id: 123456
  ) {
    deleted_discount {
      account_slug
      app_id
    }
  }
}

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

const query =
  "mutation ($slug: String!, $appId: ID!) { delete_marketplace_app_discount ( account_slug: $slug, app_id: $appId ) { deleted_discount { account_slug app_id } } }";
const variables = {
  appId: 123456,
  slug: "my-team-monday",
};
const response = await mondayApiClient.request(query, variables);

Arguments

You can use the following arguments to specify which discount to delete.

Argument	Description
account_slug `String!`	The account's slug.
app_id `ID!`	The app's unique identifier.

Error Handling

Refer to the API error handling for a list of common error types, retry strategies, and troubleshooting examples.

When calling marketplace_app_discounts, grant_marketplace_app_discount, or delete_marketplace_app_discount, you may occasionally see standard GraphQL or HTTP errors. Here are the most common categories to check:

Error Type	Description	Next Steps
Permission or collaborator error	The caller isn’t an app collaborator or the provided `app_id` doesn’t belong to them.	Verify the user token belongs to an app collaborator for the specified `app_id`.
Validation error	The query or mutation contains invalid arguments, missing fields, or is nested incorrectly.	Ensure `marketplace_app_discounts` is queried at the root level, and that all required arguments (like `app_id` or `account_slug`) are correctly typed.
Delete target not found	Trying to delete a discount that doesn’t exist for the specified account or app.	Check that the discount exists before calling `delete_marketplace_app_discount`.
Rate-limit error	Too many requests in a short period.	Wait and retry after the duration specified in the Retry-After header (if provided).
Server or network error	Temporary outage or connectivity issue.	Retry with backoff; if it persists, contact monday.com support with the `request_id`.