Help Center

What is the Agency App Reselling Config API?

The Agency App Reselling Config API is a tool that provides the final, client-facing pricing for your agency's resold applications. By using this API with a specific client account's token, you can retrieve the exact subscription, one-time, and usage-based prices that the agency has configured. This ensures the prices displayed in your custom checkout flows, plan cards, or paywalls always match the agency's billing rules and the official marketplace.

Key Benefits

Eliminate pricing discrepancies between your custom user interface and the CRM's native marketplace.
Safeguard internal costs; the API only returns the agency's marked-up selling price.
Access all billing models—subscription, one-time, and usage-based—with a single API call.
Maintain a fully white-labeled experience for your clients, with no CRM branding.
Simplify your code by dynamically fetching prices instead of hard-coding plan details and markups.

Authentication Requirements

To use this API, you must authenticate with a valid access token from a specific client (sub-account). Pricing can differ between agencies and their individual clients. Attempting to call the API with an agency-level or developer token will result in a 403 Forbidden error.

Key Authentication Points

Use OAuth 2.0 Authorization Code or Refresh Token flow.
The token must include the marketplace.app.read scope.
The current rate limit is 60 requests per minute per application, though this is subject to change.

Response Objects and Pricing Types

The API returns a JSON response organized into three main sections: subscriptionPlans, oneTimePlans, and usageMeters. Each section contains an array of objects with details like planId, planName, currency, price, and billingInterval. You can use these fields to build dynamic user interface elements such as:

Toggle buttons for monthly or annual billing cycles.
Charts showing usage tiers and overage rates.
Promotional offers based on plan names or metadata tags.

Best Practices for Displaying Prices

Follow these guidelines to build client trust and improve conversion rates:

Update prices in real-time when a user modifies their plan quantity or billing cycle selection.
Cache the API response on your server for 5 to 10 minutes to reduce calls while avoiding stale data.
Always display the currency and billing interval clearly to prevent confusion.
Use your agency's branding, such as colors and fonts, to ensure a seamless white-labeled experience.
Test scenarios where an agency might deactivate a plan or set a price to zero.

Frequently Asked Questions

Does the API return prices in the agency's currency?

Yes. Each pricing object includes a currency field, allowing you to display the correct currency symbol.

What happens if rebilling is not enabled for a client?

The API will still respond, but the price values will reflect the base marketplace cost without any agency markup.

How often should I refresh the pricing data?

It is best practice to fetch prices when a page loads and whenever a client changes their plan selections. Use server-side caching for 5-10 minutes to stay within rate limits.

Can I use an agency-level token?

No. You must use a client (sub-account) token. Agency tokens will result in a 403 Forbidden error.

Does the response include coupon or promotional discounts?

No. You will need to calculate and apply any discounts within your own application logic.

Is the endpoint rate-limited?

Yes. The current limit is 60 requests per minute per application. If you exceed this limit, you will receive a 429 status code.