Below is a developer-facing guide covering both the new, simplified Marketplace distribution model and the OAuth flow you’ll need to implement to obtain the correct access tokens.
TABLE OF CONTENTS
Article elaborating pricing models supported for each distribution model
- Target User: Agency
App Distribution Model
To configure your desired app distribution model, you have three fields:
Distribution scenarios
Article elaborating pricing models supported for each distribution model
Backward compatibility
For all existing apps, to ensure the existing installation flow and token exchange mechanism is maintained, we have configured the fields above as follows for the existing/legacy distribution types:
To make the app accessible to sub-accounts, you must ensure the app does not require any agency-level access such as:
If your app does not require any of the above: 1. Develop the OAuth flow for installation nu sub-account admins, which would generate a userType: Location token, as mentioned above. 2. Once done, change "Who can install the app?" to "Agency & sub-account" |
Target User: Agency
Choose this distribution type if your app's functionalities are applicable only to agency-level accounts.
App Listing:
Apps will be listed solely in the agency level app marketplace.
Installation and Uninstallation:
Only agency administrators or owners have the authority to install or uninstall the app at the agency account level.
Payments:
For paid applications, the installing agency is responsible for the app's cost.
Re-selling:
Agencies cannot re-sell these apps, as they are not available for installation at the sub-account level.
Target User: Sub-account | Who can install?: Agency & Sub-account
Select this type if your app's functionalities are intended for sub-account level accounts.
App Listing:
These apps are available to both agency owners/admins and sub-account admins to install. These apps are listed in both the Marketplaces to maximise the reach.
Installation and Uninstallation:
Both Sub-account admins and agency admins can install the app.
Sub-account admins can discover and install these apps to their respective sub-accounts.
Bulk Installation:
If bulk-installation is supported by the app developer, agency admins can bulk-install such apps. If not, agency admins can install the app one sub-account at a time.
Agencies can automatically install these apps for future sub-accounts if they choose the 'all sub-accounts' option during the initial installation.
Payments:
The sub-account installing a paid app will bear its cost.
Re-selling:
These apps can be re-sold by agencies. For more details on app re-selling, click here.
Target User: Sub-account | Who can install?: Agency Only
Opt for this distribution if your app is designed such a way that agency owners
App Listing:
These apps are accessible to agency admins only.
Installation and Uninstallation:
Installation and uninstallation of these apps at the sub-account level must be carried out by agency admins or owners only.
Bulk Installation:
agency admins can bulk-install such apps. If not, agency admins can install the app one sub-account at a time.
Agencies can automatically install these apps for future sub-accounts if they choose the 'all sub-accounts' option during the initial installation.
Payments:
Article elaborating pricing models supported for each distribution model
Re-selling:
Agencies can re-sell these apps to their sub-accounts, with the agency paying the base price set by the developer and sub-accounts paying a marked-up price set by the agency. For more details on app re-selling, click here.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article