Marketplace App Distribution Type

Modified on: Tue, 15 Oct, 2024 at 1:09 AM

This article outlines the available distribution types—Agency, Subaccount, and Agency & Subaccount—and provides insights to help developers select the best fit for their app, detailing listing visibility, installation protocols, payment processes, and re-selling capabilities.

TABLE OF CONTENTS

What Are Distribution Types?
Summary
Distribution Type - Agency
Distribution Type - Sub-account
Distribution Type - Agency and Sub-account

What Are Distribution Types?

Distribution types determine the placement of your app within the appropriate account level (Agency or Subaccount) and grant corresponding app-level access. We currently support three distribution types:

Agency
Subaccount
Agency & Subaccount

Summary

	Distribution Types
	Agency Only	Sub-account Only	Agency & Sub-account
Where is the app listed?	App is listed in the Agency Marketplace	App is listed in the Sub-account Marketplace	App is listed in the Agency Marketplace
Who can install the app?	Agency admins can install the app	Sub-account admins can install the app	Agency admins can bulk install the app across multiple sub-accounts. Agency may also set to automatically install the app to future onboarded sub-accounts
How does the pricing work?	Please refer to this section for all details on pricing model variations across different distribution types.
*[Advanced]* Which user's data/scopes can the app's tokens access?	Agency scopes only	Sub-account scopes only	Agency scopes and sub-account scopes

Distribution Type - 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.

Distribution Type - Sub-account

Select this type if your app's functionalities are intended for sub-account level accounts.

App Listing:

These apps are listed exclusively at the sub-account level.

Installation and Uninstallation:

Sub-account administrators can install the app at their respective account levels. These apps do not support agency level installation or bulk installation across multiple sub-accounts.

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.

Distribution Type - Agency and Sub-account

Opt for this distribution if your app's functionalities are relevant at both the agency and sub-account levels.

App Listing:

These apps are accessible in both agency and sub-account level marketplaces.

Installation and Uninstallation:

Installation and uninstallation of these apps at the sub-account level must be carried out by agency admins or owners only. Sub-account admins cannot perform these actions.

Bulk Installation:

Agencies can bulk install these apps across their sub-accounts at the time of installation, choosing either all existing sub-accounts or a specific subset. Each sub-account installed with the app will incur charges if the app is paid.

Future Installation:

Agencies can automatically install these apps for future sub-accounts if they choose the 'all sub-accounts' option during the initial installation.

Payments:

Upon installation, both the agency and the sub-account are charged for paid apps.

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.