Import Data API


The Import Data API allows you to bring external data into GrowPanel so the system can build full MRR and transaction reports. You can import customers, plans, and invoices from your external sources, such as Stripe, Braintree, or other billing platforms.

Imported data is used to:

  • Calculate MRR, ARR, and other subscription metrics.
  • Track customer movements: new, expansion, contraction, churn, and reactivation.
  • Generate detailed transaction reports for your accounting and analytics.

Supported data types

Data typeDescription
CustomersImport your customer records, including subscription status, start dates, and metadata.
PlansImport your subscription plans with billing frequency, product name, and currency.
InvoicesImport invoices to reconcile payments and calculate revenue movements.

How it works

  1. Send data via API
    Use the endpoints under /data/customers, /data/plans, and /data/invoices to push your external data into GrowPanel.

  2. Validation and deduplication
    The API validates required fields, checks for duplicates, and performs bulk upserts when needed.

  3. Data processing
    Once imported, the system automatically updates your MRR and transaction reports, calculating all relevant metrics and movements.

  4. Reporting
    You can then query the reports endpoints to get full analytics for your account, including historical trends and customer insights.


Example workflow

  1. Export your data from your billing system.
  2. Use the Import Data API to send customers, plans, and invoices to GrowPanel.
  3. Wait for the system to process the data (usually a few seconds for bulk imports).
  4. Query the MRR reports and transactions reports endpoints to view updated metrics.

By using the Import Data API, you ensure your reports are always accurate and up to date, regardless of your external billing platform.